Remade for development-2.3
[kopensolaris-gnu/glibc.git] / README
1 This directory contains the version 2.3 release of the GNU C Library.
2 Many bugs have been fixed since the last release.
3 Some bugs surely remain.
4
5 As of this release, the GNU C library is known to run on the following
6 configurations:
7
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+ 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.x on IBM S/390 64-bit
23                 sh-*-linux-gnu          Linux-2.x on Super Hitachi
24                 cris-*-linux-gnu        Linux-2.4+ on CRIS
25
26 Former releases of this library (version 1.09.1 and perhaps earlier
27 versions) used to run on the following configurations:
28
29                 alpha-dec-osf1
30                 i[3456]86-*-bsd4.3
31                 i[3456]86-*-isc2.2
32                 i[3456]86-*-isc3
33                 i[3456]86-*-sco3.2
34                 i[3456]86-*-sco3.2v4
35                 i[3456]86-*-sysv
36                 i[3456]86-*-sysv4
37                 i[3456]86-force_cpu386-none
38                 i[3456]86-sequent-bsd
39                 i960-nindy960-none
40                 m68k-hp-bsd4.3
41                 m68k-mvme135-none
42                 m68k-mvme136-none
43                 m68k-sony-newsos3
44                 m68k-sony-newsos4
45                 m68k-sun-sunos4
46                 mips-dec-ultrix4
47                 mips-sgi-irix4
48                 sparc-sun-solaris2
49                 sparc-sun-sunos4
50
51 Since no one has volunteered to test and fix the above configurations,
52 these are not supported at the moment.  It's expected that these don't
53 work anymore.  Porting the library is not hard.  If you are interested
54 in doing a port, please contact the glibc maintainers by sending
55 electronic mail to <bug-glibc@gnu.org>.
56
57 There are some add-ons which can be used together with GNU libc.  They
58 are designed in a way to ease the installation by integrating them in
59 the libc source tree.  Simply get the add-ons you need and use the
60 --enable-add-ons option of the `configure' script to tell where the
61 add-ons are found.  Please read the FAQ file for more details.
62
63 See the file INSTALL to find out how to configure, build, install, and port
64 the GNU C library.  You might also consider reading the WWW pages for the
65 GNU libc at http://www.gnu.org/software/libc/libc.html.
66
67 The GNU C Library is completely documented by the Texinfo manual found
68 in the `manual/' subdirectory.  The manual is still being updated and
69 contains some known errors and omissions; we regret that we do not
70 have the resources to work on the manual as much as we would like.
71 Please send comments on the manual to <bug-glibc-manual@gnu.org>, and
72 not to the library bug-reporting address.
73
74 The file NOTES contains a description of the feature-test macros used
75 in the GNU C library, explaining how you can tell the library what
76 facilities you want it to make available.
77
78 We prefer to get bug reports sent using the `glibcbug' shell script which
79 is installed together with the rest of the GNU libc to <bugs@gnu.org>.
80 Simply run this shell script and fill in the information.  Nevertheless
81 you can still send bug reports to <bug-glibc@gnu.org> as normal electronic
82 mails.
83
84 The GNU C Library is free software.  See the file COPYING.LIB for copying
85 conditions, and LICENSES for notices about a few contributions that require
86 these additional notices to be distributed.