makefile hacks for using upstream tarballs
[glibc.git] / README.template
blobd501d718dfc48292aadf34a2fe755e61aac6994d
1 This directory contains the version VERSION release of the GNU C Library.
2 Many bugs have been fixed since the last release.
3 Some bugs surely remain.
5 As of this release, the GNU C library is known to run on the following
6 configurations:
8                 *-*-gnu                 GNU Hurd
9                 i[3456]86-*-linux-gnu   Linux-2.x on Intel
10                 m68k-*-linux-gnu        Linux-2.x on Motorola 680x0
11                 alpha*-*-linux-gnu      Linux-2.x on DEC Alpha
12                 powerpc-*-linux-gnu     Linux and MkLinux on PowerPC systems
13                 powerpc64-*-linux-gnu   Linux-2.4.19+ on 64-bit PowerPC systems
14                 sparc-*-linux-gnu       Linux-2.x on SPARC
15                 sparc64-*-linux-gnu     Linux-2.x on UltraSPARC 64-bit
16                 arm-*-none              ARM standalone systems
17                 arm-*-linux             Linux-2.x on ARM
18                 arm-*-linuxaout         Linux-2.x on ARM using a.out binaries
19                 mips*-*-linux-gnu       Linux-2.x on MIPS
20                 ia64-*-linux-gnu        Linux-2.x on ia64
21                 s390-*-linux-gnu        Linux-2.x on IBM S/390
22                 s390x-*-linux-gnu       Linux-2.4+ on IBM S/390 64-bit
23                 sh-*-linux-gnu          Linux-2.x on Super Hitachi
24                 x86-64-*-linux-gnu      Linux-2.4+ on x86-64
26 Past releases of this library ran on a variety of configurations that are
27 no longer supported.  Porting the library is not hard.  If you are
28 interested in doing a port, please contact the glibc maintainers;
29 see http://www.gnu.org/software/libc/ for more information.
31 There are some add-ons which can be used together with GNU libc.  They
32 are designed in a way to ease the installation by integrating them in
33 the libc source tree.  Simply get the add-ons you need and use the
34 --enable-add-ons option of the `configure' script to tell where the
35 add-ons are found.  Please read the FAQ file for more details.
37 See the file INSTALL to find out how to configure, build, install, and port
38 the GNU C library.  You might also consider reading the WWW pages for the
39 GNU libc at http://www.gnu.org/software/libc/libc.html.
41 The GNU C Library is completely documented by the Texinfo manual found
42 in the `manual/' subdirectory.  The manual is still being updated and
43 contains some known errors and omissions; we regret that we do not
44 have the resources to work on the manual as much as we would like.
45 Please send comments on the manual to <bug-glibc-manual@gnu.org>, and
46 not to the library bug-reporting address.
48 The file NOTES contains a description of the feature-test macros used
49 in the GNU C library, explaining how you can tell the library what
50 facilities you want it to make available.
52 Please see http://www.gnu.org/software/libc/bugs.html for bug reporting
53 information.  We are now using the Bugzilla system to track all bug reports.
54 This web page gives detailed information on how to report bugs properly.
56 The GNU C Library is free software.  See the file COPYING.LIB for copying
57 conditions, and LICENSES for notices about a few contributions that require
58 these additional notices to be distributed.