(svcudp_bufcreate): Declare len as socklen_t.
[kopensolaris-gnu/glibc.git] / README.template
index b04ae20..e9049b8 100644 (file)
@@ -2,45 +2,94 @@ This directory contains the version VERSION test release of the GNU C Library.
 Many bugs have been fixed since the last release.
 Some bugs surely remain.
 
-As of this release, the GNU C library has been ported to: sparcs and Sun 3s
-running SunOS 4.1, HP 9000/300 and Sony NEWS workstations running 4.3 BSD,
-and MIPS DECStations running Ultrix 4.  The port to the i386 running
-either System V, SVR4, or BSD, is mostly complete but has not been well
-tested.  Porting the library is not hard.  If you are interested in doing a
-port, please get on the mailing list by sending electronic mail to
-bug-glibc-request@prep.ai.mit.edu
+As of this release, the GNU C library is known to run on the following
+configurations:
+
+               *-*-gnu                 GNU Hurd
+               i[3456]86-*-linux-gnu   Linux-2.x on Intel
+               m68k-*-linux-gnu        Linux-2.x on Motorola 680x0
+               alpha-*-linux-gnu       Linux-2.x on DEC Alpha
+               powerpc-*-linux-gnu     Linux and MkLinux on PowerPC systems
+               sparc-*-linux-gnu       Linux-2.x on SPARC
+               sparc64-*-linux-gnu     Linux-2.x on UltraSPARC
+               arm-*-none              ARM standalone systems
+               arm-*-linux             Linux-2.x on ARM
+               arm-*-linuxaout         Linux-2.x on ARM using a.out binaries
+
+
+Former releases of this library (version 1.09.1 and perhaps earlier
+versions) used to run on the following configurations:
+
+               alpha-dec-osf1
+               i[3456]86-*-bsd4.3
+               i[3456]86-*-isc2.2
+               i[3456]86-*-isc3
+               i[3456]86-*-sco3.2
+               i[3456]86-*-sco3.2v4
+               i[3456]86-*-sysv
+               i[3456]86-*-sysv4
+               i[3456]86-force_cpu386-none
+               i[3456]86-sequent-bsd
+               i960-nindy960-none
+               m68k-hp-bsd4.3
+               m68k-mvme135-none
+               m68k-mvme136-none
+               m68k-sony-newsos3
+               m68k-sony-newsos4
+               m68k-sun-sunos4
+               mips-dec-ultrix4
+               mips-sgi-irix4
+               sparc-sun-solaris2
+               sparc-sun-sunos4
+
+Since no one has volunteered to test and fix the above configurations,
+these are not supported at the moment.  It's expected that these don't
+work anymore.  Porting the library is not hard.  If you are interested
+in doing a port, please contact the glibc maintainers by sending
+electronic mail to <bug-glibc@gnu.org>.
 
 The GNU C library now includes Michael Glad's Ultra Fast Crypt, which
-provides the Unix `crypt' function, plus some other entry points.  Because
-of the United States export restriction on DES implementations, we are
-distributing this code separately from the rest of the C library.  There is
-an extra distribution tar file just for crypt; it is called
-`glibc-VERSION-crypt.tar.Z'.  You can just unpack the crypt distribution
-along with the rest of the C library and build; you can also build the
-library without getting crypt.  Users outside the USA can get the crypt
-distribution via anonymous FTP from ftp.uni-c.dk [129.142.6.74], or another
-archive site outside the USA.  Archive maintainers are encouraged to copy
-this distribution to their archives outside the USA.  Please get it from
-ftp.uni-c.dk; transferring this distribution from prep.ai.mit.edu (or any
-other site in the USA) to a site outside the USA is in violation of US
-export laws.
+provides the Unix `crypt' function, plus some other entry points.
+Because of the United States export restriction on DES implementations,
+we are distributing this code separately from the rest of the C
+library.  There is an extra distribution tar file just for crypt; it is
+called `glibc-crypt-VERSION.tar.gz'.  You can just unpack the crypt
+distribution along with the rest of the C library and build; you can
+also build the library without getting crypt.  Users outside the USA
+can get the crypt distribution via anonymous FTP from ftp.ifi.uio.no
+[129.240.64.21], or another archive site outside the USA.  Archive
+maintainers are encouraged to copy this distribution to their archives
+outside the USA.  Please get it from ftp.ifi.uio.no; transferring this
+distribution from ftp.gnu.org (or any other site in the USA) to a
+site outside the USA is in violation of US export laws.
+
+Beside the separate crypt tar file there are some more add-ons which can be
+used together with GNU libc.  They are designed in a way to ease the
+installation by integrating them in the libc source tree.  Simply get the
+add-ons you need and use the --enable-add-ons option of the `configure'
+script to tell where the add-ons are found.  Please read the FAQ file for
+more details.
 
 See the file INSTALL to find out how to configure, build, install, and port
-the GNU C library.
+the GNU C library.  You might also consider reading the WWW pages for the
+GNU libc at http://www.gnu.org/software/libc/libc.html.
 
-The manual for the GNU C library is still being worked on, and is not yet
-distributed.
+The GNU C Library is completely documented by the Texinfo manual found
+in the `manual/' subdirectory.  The manual is still being updated and
+contains some known errors and omissions; we regret that we do not
+have the resources to work on the manual as much as we would like.
+Please send comments on the manual to <bug-glibc-manual@gnu.org>, and
+not to the library bug-reporting address.
 
-The file NOTES contains a description of the feature-test macros used in
-the GNU C library, explaining how you can tell the library what facilities
-you want it to make available.
+The file NOTES contains a description of the feature-test macros used
+in the GNU C library, explaining how you can tell the library what
+facilities you want it to make available.
 
-Send bug reports to bug-glibc@prep.ai.mit.edu.
+We prefer to get bug reports sent using the `glibcbug' shell script which
+is installed together with the rest of the GNU libc to <bugs@gnu.org>.
+Simply run this shell script and fill in the information.  Nevertheless
+you can still send bug reports to <bug-glibc@gnu.org> as normal electronic
+mails.
 
 The GNU C Library is free software.  See the file COPYING.LIB for copying
 conditions.
-
-Please note that there are some files in the distribution whose names
-exceed 14 characters in length.  None of these files are needed to build
-the library on System V, where a 14 character limit on the length of file
-names is imposed, so this is harmless.