OSDN Git Service

h8300: O_DIRECT and O_DIRECTIRY swapping.
[uclinux-h8/uclibc-ng.git] / README
diff --git a/README b/README
index 6511c9f..002b6f9 100644 (file)
--- a/README
+++ b/README
@@ -1,48 +1,48 @@
+  uClibc-ng - a small C Library for Linux
+
+uClibc-ng (aka µClibc-ng/pronounced yew-see-lib-see-next-generation) is a C
+library for developing embedded Linux systems. It is much smaller than the GNU
+C Library, but nearly all applications supported by glibc also work perfectly
+with uClibc-ng.
+
+uClibc-ng is a spin-off of uClibc from http://www.uclibc.org
+from Erik Andersen and others.
+
+Porting applications from glibc to uClibc-ng typically involves just
+recompiling the source code.  uClibc-ng even supports shared libraries and
+threading. It currently runs on standard Linux and MMU-less (also
+known as µClinux) systems with support for ARC, ARM, Blackfin, i386, M68K/Coldfire
+MIPS, MIPS64, PowerPC, SH, Sparc, X86_64 and XTENSA processors.
+
+If you are building an embedded Linux system and you find that
+glibc is eating up too much space, you should consider using
+uClibc-ng.  If you are building a huge fileserver with 12 Terabytes
+of storage, then using glibc may make more sense.  Unless, for
+example, that 12 Terabytes will be Network Attached Storage and
+you plan to burn Linux into the system's firmware...
+
+uClibc-ng is maintained by Waldemar Brodkorb and is licensed under the
+GNU LESSER GENERAL PUBLIC LICENSE.  This license allows you to
+make closed source commercial applications using an unmodified
+version of uClibc-ng. You do not need to give away all your source code just
+because you use uClibc-ng and/or run on Linux.  You should, however,
+carefuly review the license and make certain you understand and
+abide by it strictly.
 
-  uClibc - a Small C Library for Linux
-  Erik Andersen <andersen@codepoet.org>
+For installation instructions, see the file INSTALL.
 
-uClibc (aka µClibc/pronounced yew-see-lib-see) is a size-optimized
-implementation of the standard C library.  It is primarily designed
-for developing embedded Linux systems.  It is much smaller then the
-GNU C Library, but nearly all applications supported by glibc also
-work perfectly with uClibc. Porting applications from glibc to
-uClibc typically involves just recompiling the source code. uClibc
-even supports shared libraries and threading. It currently runs on
-standard Linux and MMU-less (also known as µClinuxClinux) systems
-with support for ARM, i386, h8300, m68k, mips, mipsel, PowerPC, SH,
-SPARC, and v850 processors.
+uClibc-ng strives to be standards compliant, which means that most
+documentation written for SuSv3, or for glibc also applies to
+uClibc-ng functions.  However, many GNU extensions are not supported
+because they have not been ported, or more importantly, would
+increase the size of uClibc-ng disproportional to the added
+functionality.
 
-For installation instructions, see the file INSTALL.
+Additional information can be found at http://www.uclibc-ng.org/.
 
-This distribution contains a wrapper for gcc and ld that allows you
-to use existing toolchains that were targetted for glibc.  See
-extra/gcc-uClibc/ for information.
-
-uClibc strives to be standards compliant, which means that most
-documentation written for functions in glibc also apply to uClibc
-functions.  However, many GNU extensions are not supported because
-they have not been ported, or more importantly, would increase the
-size of uClibc disproportional to the added functionality.
-
-Additional information (recent releases, FAQ, mailing list, bugs,
-etc.) can be found at http://www.uclibc.org/.
-
-uClibc may be freely modified distributed under the terms of the
-GNU Library General Public License, which can be found in the
-file COPYING.LIB.
-
-Please Note:
-
-       There is an unwholesomely huge amount of code out there
-       that depends on the presence of GNU libc header files.
-       We have GNU libc header files.  So we have committed a
-       horrible sin in uClibc.  We _lie_ and claim to be GNU
-       libc in order to force these applications to work as their
-       developers intended.  This is IMHO, pardonable, since
-       these defines are not really intended to check for the
-       presence of a particular library, but rather are used to
-       define an _interface_.  Some programs (such as GNU
-       binutils) are especially chummy with glibc, and need this
-       behavior disabled by adding CFLAGS+=__FORCE_NOGLIBC
+uClibc-ng may be freely modified and distributed under the terms of
+the GNU Lesser General Public License, which can be found in the
+file COPYING.
 
+And most of all, be sure to have some fun! :-)
+ -Waldemar