Packaging hints for binary package distributors
===============================================

Although the source of the gettext package comes as a single package,
I recommend that in distributions of binary packages the installed files
be split into two packages:

   gettext
        Contents: Runtime libraries and programs.
        Audience: Anyone who wants to run internationalized programs.

   gettext-tools
        Contents: Tools and documentation for developers and translators.
        Audience: Anyone who wants to develop or localize internationalized
                  programs, i.e. developers and translators.
        Dependencies: requires gettext.

The 'gettext' binary package is much smaller than the 'gettext-tools' binary
package (90 KB versus 4 MB). I recommend to include it in the default
installation list, like GNU 'sh-utils'; in fact, the runtime programs are
utilities for sh programs.

The precise split between gettext and gettext-tools is according to the
following file list.

   gettext

      $prefix/bin/gettext
      $prefix/bin/ngettext
      $prefix/man/man1/gettext.1
      $prefix/man/man1/ngettext.1
      $prefix/doc/gettext/gettext.1.html
      $prefix/doc/gettext/ngettext.1.html
      $prefix/share/gettext/ABOUT-NLS
      $prefix/share/gettext/libintl.jar
      $prefix/lib/libintl.*               (not installed on glibc systems)
      $prefix/lib/charset.alias           (not installed on glibc systems)
      $prefix/share/locale/locale.alias   (not installed on glibc systems)
      $prefix/include/libintl.h           (not installed on glibc systems)

   gettext-tools

      Everything else, i.e. currently:

      $prefix/bin/msg*
      $prefix/bin/xgettext
      $prefix/bin/gettextize
      $prefix/bin/autopoint
      $prefix/man/man1/msg*.1
      $prefix/man/man1/xgettext.1
      $prefix/man/man1/gettextize.1
      $prefix/man/man1/autopoint.1
      $prefix/man/man3/*
      $prefix/doc/gettext/msg*.1.html
      $prefix/doc/gettext/xgettext.1.html
      $prefix/doc/gettext/gettextize.1.html
      $prefix/doc/gettext/autopoint.1.html
      $prefix/doc/gettext/*.3.html
      $prefix/doc/gettext/javadoc1/*
      $prefix/doc/gettext/javadoc2/*
      $prefix/doc/gettext/gettext_*.html
      $prefix/info/gettext.info*
      $prefix/lib/libgettextlib*
      $prefix/lib/libgettextsrc*
      $prefix/lib/gettext/*
      $prefix/share/locale/*/LC_MESSAGES/gettext.mo
      $prefix/share/gettext/config.rpath
      $prefix/share/gettext/mkinstalldirs
      $prefix/share/gettext/intl/*
      $prefix/share/gettext/po/*
      $prefix/share/gettext/projects/*
      $prefix/share/gettext/gettext.h
      $prefix/share/gettext/gettext.jar
      $prefix/share/gettext/msgunfmt.tcl
      $prefix/share/gettext/archive.tar.gz
      $prefix/share/aclocal/codeset.m4
      $prefix/share/aclocal/gettext.m4
      $prefix/share/aclocal/glibc21.m4
      $prefix/share/aclocal/iconv.m4
      $prefix/share/aclocal/isc-posix.m4
      $prefix/share/aclocal/lcmessage.m4
      $prefix/share/aclocal/lib-ld.m4
      $prefix/share/aclocal/lib-link.m4
      $prefix/share/aclocal/lib-prefix.m4
      $prefix/share/aclocal/progtest.m4
      $prefix/share/emacs/site-lisp/po-compat.el
      $prefix/share/emacs/site-lisp/po-compat.elc
      $prefix/share/emacs/site-lisp/po-mode.el
      $prefix/share/emacs/site-lisp/po-mode.elc