-This directory is an add-on for the GNU C Library (glibc).
-It provides additional ports to machines and/or operating systems that are
-not maintained in the official glibc source tree.
-
-The scripts in the top level of this directory provide the infrastructure
-necessary for a glibc add-on. You can make a new add-on containing one or
-more ports by copying configure, configure.in, and Makeconfig into your own
-add-on directory, which you can give any name (it doesn't have to be
-`ports'). You may want to include a README and Banner of your own talking
-about your port's code in particular, rather than the generic ones here.
-
-The real source code for any ports is found in the sysdeps/ subdirectories.
-These should be exactly what would go into the main libc source tree if you
-were to incorporate it directly. The only exceptions are the files
-sysdeps/*/preconfigure and sysdeps/*/preconfigure.in; these are fragments
-used by this add-on's configure fragment. The purpose of these is to set
-$base_machine et al when the main libc configure's defaults are not right
-for some machine. Everything else can and should be done from a normal
-sysdeps/.../configure fragment that is used only when the configuration
-selects that sysdeps subdirectory. Each port that requires some special
-treatment before the sysdeps directory list is calculated, should add a
-sysdeps/CPU/preconfigure file; this can either be written by hand or
-generated by Autoconf from sysdeps/CPU/preconfigure.in, and follow the
-rules for glibc add-on configure fragments. No preconfigure file should do
-anything on an unrelated configuration, so that disparate ports can be put
-into a single add-on without interfering with each other.
-
-Like all glibc add-ons, the only way to use this is to place this directory
-(just a symlink won't do) inside the top-level glibc source directory.
-Then include the name of this directory (e.g. `ports') when you specify
-`--enable-add-ons=...' to glibc's configure (or use just --enable-add-ons
-to have it try every add-on directory sitting in your source tree).
-
-If you find problems with the top-level scripts in this add-on, please go
-to http://sources.redhat.com/bugzilla/ and file a report for the glibc
-under the "admin" component.
-
-
-$Id$
+This directory contains the sources of the GNU C Library.
+See the file "version.h" for what release version you have.
+
+The GNU C Library is the standard system C library for all GNU systems,
+and is an important part of what makes up a GNU system. It provides the
+system API for all programs written in C and C-compatible languages such
+as C++ and Objective C; the runtime facilities of other programming
+languages use the C library to access the underlying operating system.
+
+In GNU/Linux systems, the C library works with the Linux kernel to
+implement the operating system behavior seen by user applications.
+In GNU/Hurd systems, it works with a microkernel and Hurd servers.
+
+The GNU C Library implements much of the POSIX.1 functionality in the
+GNU/Hurd system, using configurations i[4567]86-*-gnu.
+
+When working with Linux kernels, this version of the GNU C Library
+requires Linux kernel version 3.2 or later.
+
+Also note that the shared version of the libgcc_s library must be
+installed for the pthread library to work correctly.
+
+The GNU C Library supports these configurations for using Linux kernels:
+
+ aarch64*-*-linux-gnu
+ alpha*-*-linux-gnu
+ arm-*-linux-gnueabi
+ csky-*-linux-gnuabiv2
+ hppa-*-linux-gnu
+ i[4567]86-*-linux-gnu
+ x86_64-*-linux-gnu Can build either x86_64 or x32
+ ia64-*-linux-gnu
+ m68k-*-linux-gnu
+ microblaze*-*-linux-gnu
+ mips-*-linux-gnu
+ mips64-*-linux-gnu
+ powerpc-*-linux-gnu Hardware or software floating point, BE only.
+ powerpc64*-*-linux-gnu Big-endian and little-endian.
+ s390-*-linux-gnu
+ s390x-*-linux-gnu
+ riscv64-*-linux-gnu
+ sh[34]-*-linux-gnu
+ sparc*-*-linux-gnu
+ sparc64*-*-linux-gnu
+
+If you are interested in doing a port, please contact the glibc
+maintainers; see http://www.gnu.org/software/libc/ for more
+information.
+
+See the file INSTALL to find out how to configure, build, and install
+the GNU C Library. You might also consider reading the WWW pages for
+the C library at http://www.gnu.org/software/libc/.
+
+The GNU C Library is (almost) 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. For
+corrections to the manual, please file a bug in the `manual' component,
+following the bug-reporting instructions below. Please be sure to check
+the manual in the current development sources to see if your problem has
+already been corrected.
+
+Please see http://www.gnu.org/software/libc/bugs.html for bug reporting
+information. We are now using the Bugzilla system to track all bug reports.
+This web page gives detailed information on how to report bugs properly.
+
+The GNU C Library is free software. See the file COPYING.LIB for copying
+conditions, and LICENSES for notices about a few contributions that require
+these additional notices to be distributed. License copyright years may be
+listed using range notation, e.g., 1996-2015, indicating that every year in
+the range, inclusive, is a copyrightable year that would otherwise be listed
+individually.
projects / thirdparty / glibc.git / blobdiff