Generate gap table.
[kopensolaris-gnu/glibc.git] / README.template
1 This directory contains the version VERSION test 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                 sparc-*-linux-gnu       Linux-2.x on SPARC
14                 sparc64-*-linux-gnu     Linux-2.x on UltraSPARC
15                 arm-*-none              ARM standalone systems
16                 arm-*-linuxaout         Linux-2.x on ARM using a.out binaries
17
18
19 Former releases of this library (version 1.09.1 and perhaps earlier
20 versions) used to run on the following configurations:
21
22                 alpha-dec-osf1
23                 i[3456]86-*-bsd4.3
24                 i[3456]86-*-isc2.2
25                 i[3456]86-*-isc3
26                 i[3456]86-*-sco3.2
27                 i[3456]86-*-sco3.2v4
28                 i[3456]86-*-sysv
29                 i[3456]86-*-sysv4
30                 i[3456]86-force_cpu386-none
31                 i[3456]86-sequent-bsd
32                 i960-nindy960-none
33                 m68k-hp-bsd4.3
34                 m68k-mvme135-none
35                 m68k-mvme136-none
36                 m68k-sony-newsos3
37                 m68k-sony-newsos4
38                 m68k-sun-sunos4
39                 mips-dec-ultrix4
40                 mips-sgi-irix4
41                 sparc-sun-solaris2
42                 sparc-sun-sunos4
43
44 Since no one has volunteered to test and fix the above configurations,
45 these are not supported at the moment.  It's expected that these don't
46 work anymore.  Porting the library is not hard.  If you are interested
47 in doing a port, please contact the glibc maintainers by sending
48 electronic mail to <bug-glibc@gnu.org>.
49
50 The GNU C library now includes Michael Glad's Ultra Fast Crypt, which
51 provides the Unix `crypt' function, plus some other entry points.
52 Because of the United States export restriction on DES implementations,
53 we are distributing this code separately from the rest of the C
54 library.  There is an extra distribution tar file just for crypt; it is
55 called `glibc-crypt-VERSION.tar.gz'.  You can just unpack the crypt
56 distribution along with the rest of the C library and build; you can
57 also build the library without getting crypt.  Users outside the USA
58 can get the crypt distribution via anonymous FTP from ftp.ifi.uio.no
59 [129.240.64.21], or another archive site outside the USA.  Archive
60 maintainers are encouraged to copy this distribution to their archives
61 outside the USA.  Please get it from ftp.ifi.uio.no; transferring this
62 distribution from ftp.gnu.org (or any other site in the USA) to a
63 site outside the USA is in violation of US export laws.
64
65 Beside the separate crypt tar file there are some more add-ons which can be
66 used together with GNU libc.  They are designed in a way to ease the
67 installation by integrating them in the libc source tree.  Simply get the
68 add-ons you need and use the --enable-add-ons option of the `configure'
69 script to tell where the add-ons are found.  Please read the FAQ file for
70 more details.
71
72 See the file INSTALL to find out how to configure, build, install, and port
73 the GNU C library.  You might also consider reading the WWW pages for the
74 GNU libc at http://www.gnu.org/software/libc/libc.html.
75
76 The GNU C Library is completely documented by the Texinfo manual found
77 in the `manual/' subdirectory.  The manual is still being updated and
78 contains some known errors and omissions; we regret that we do not
79 have the resources to work on the manual as much as we would like.
80 Please send comments on the manual to <bug-glibc-manual@gnu.org>, and
81 not to the library bug-reporting address.
82
83 The file NOTES contains a description of the feature-test macros used
84 in the GNU C library, explaining how you can tell the library what
85 facilities you want it to make available.
86
87 We prefer to get bug reports sent using the `glibcbug' shell script which
88 is installed together with the rest of the GNU libc to <bugs@gnu.org>.
89 Simply run this shell script and fill in the information.  Nevertheless
90 you can still send bug reports to <bug-glibc@gnu.org> as normal electronic
91 mails.
92
93 The GNU C Library is free software.  See the file COPYING.LIB for copying
94 conditions.