]> git.ipfire.org Git - thirdparty/glibc.git/blobdiff - README
iconv, localedef: avoid floating point rounding differences [BZ #24372]
[thirdparty/glibc.git] / README
diff --git a/README b/README
index 3ad8078542b290790d08f4c1b8e66a7c34d57a55..eb9b0b34a35e63712fd6146f752a188cce694c67 100644 (file)
--- a/README
+++ b/README
@@ -1,48 +1,72 @@
-This is the glibc ports repository, an add-on for the GNU C Library (glibc).
-It contains code that is not maintained in the official glibc source tree.
-
-This includes working ports to GNU/Linux on some machine architectures that
-are not maintained in the official glibc source tree.  It also includes
-some code once used by old libc ports now defunct, which has been abandoned
-but may be useful for some future porter to examine.  It may also include
-some optimized functions tailored for specific CPU implementations of an
-architecture, to be selected using --with-cpu.
-
-The ports repository is cooperatively maintained by volunteers on the
-<libc-ports@sourceware.org> mailing list, and housed in the glibc CVS as a
-module called "ports".  See http://www.gnu.org/software/libc/resources.html
-for details on using CVS.  To report a bug in code housed in the ports
-repository, please go to http://sources.redhat.com/bugzilla/ and file a bug
-report under the glibc "ports" component.
-
-An add-on for an individual port can be made from just the sysdeps/
-subdirectories containing the port's code.  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, this must be used by specifying the directory in
-the --enable-add-ons option when running glibc's configure script.
-
-The GNU C Library is free software.  See the file COPYING.LIB in the
-libc repository 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., 2000-2011, indicating that every year in the range,
-inclusive, is a copyrightable year that would otherwise be listed
+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.