Update.

[kopensolaris-gnu/glibc.git] / README.template

diff --git a/README.template b/README.template
index 441eeba..5687384 100644 (file)
--- a/README.template
+++ b/README.template
@@ -2,30 +2,88 @@ 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.
 
 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.2.  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:
+
+               i[3456]86-*-gnu         GNU Hurd
+               i[3456]86-*-linux-gnu   Linux-2.0 on Intel
+               m68k-*-linux-gnu        Linux-2.0 on Motorola 680x0
+               alpha-*-linux-gnu       Linux-2.0 on DEC Alpha
+
+
+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@prep.ai.mit.edu>.
+
+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-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 prep.ai.mit.edu (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
 
 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@prep.ai.mit.edu>, 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 install 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@prep.ai.mit.edu> as normal
+electronic mails.

 
 The GNU C Library is free software.  See the file COPYING.LIB for copying
 conditions.
 
 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.