gettext/INSTALL
Bruno Haible 2e779cb324 Add installation information for the tarball users and from a git checkout.
We want to have an INSTALL file that contains installation instructions for
the tarball users. These instructions are necessarily package specific,
because they need to list the prerequisites or reference the DEPENDENCIES
file.

Additionally, many people who are not aware that tarballs are the primary
means for source code distribution of GNU packages check out the git repository
and then expect to see instructions for installing from that git checkout
in the INSTALL file. See e.g. <https://savannah.gnu.org/bugs/?62196>.

Unfortunately, both Automake (with strictness option = 'gnu') and 'bootstrap'
both contain code to copy the generic (not package specific) installation
instructions to the file 'INSTALL'. This is not what we want, so we disable
it. (Other packages handle this issue by putting part of the installation
instructions into the README file. This is suboptimal, because this is not
what the README file is for.)

* autogen.sh: Import INSTALL.generic from gnulib.
* INSTALL: Entirely rewritten, based on poke/INSTALL.
* Makefile.am (EXTRA_DIST): Add INSTALL.generic.
* libtextstyle/autogen.sh: Import INSTALL.generic from gnulib.
* libtextstyle/INSTALL: Entirely rewritten, based on poke/INSTALL.
* libtextstyle/Makefile.am (EXTRA_DIST): Add INSTALL.generic.
2024-11-27 11:40:31 +01:00

41 lines
1.0 KiB
Plaintext

This file explains how to install GNU gettext from a tarball.
(If you have checked out the source code repository, start by reading the
file HACKING instead.)
Prerequisites
=============
Before starting the installation, install the prerequisites listed in the
file DEPENDENCIES. You need to have at least those marked as 'Mandatory'
installed.
Installation
============
Then, you can run 'configure':
$ mkdir build/ && cd build
$ ../configure
Here, you can give as arguments to 'configure'
- configure options, as listen in the 'configure --help' output,
- Makefile variable assignments for building the binaries, as
described in the INSTALL.generic file.
If you are in a 64-bit multilib system with support for building 32-bit
binaries, you can build a 32-bit poke configuring like this:
$ ../configure CC="gcc -m32"
You find a set of known-to-work variable settings for various platforms
in https://gitlab.com/ghwiki/gnow-how/-/wikis/Platforms/Configuration .
Finally:
$ make
$ make check
$ make install