X-Git-Url: http://nsz.repo.hu/git/?p=musl;a=blobdiff_plain;f=README;h=9df22055c709e2a0b8986c2f984202bff9aa92da;hp=a57541c6755bbead67de9cb0eba50354476eed47;hb=b72db3d1ed561d31d059acc7e9a5aacb8c5ee9ac;hpb=0b44a0315b47dd8eced9f3b7f31580cf14bbfc01 diff --git a/README b/README index a57541c6..9df22055 100644 --- a/README +++ b/README @@ -12,30 +12,47 @@ comparison chart on the project website, For installation instructions, see the INSTALL file. -Please refer to the COPYRIGHT file for details on the copyright status -of code included in musl, and the COPYING file for the license (LGPL) -under which the library as a whole is distributed. - - - -Greetings libc hackers! - -This package is an _alpha_ release of musl, intended for the curious -and the adventurous. While it can be used to build a complete small -Linux system (musl is self-hosted on the system I use to develop it), -at this point doing so requires a lot of manual effort. Nonetheless, I -hope low-level Linux enthusiasts will try out building some compact -static binaries with musl using the provided gcc wrapper (which allows -you to link programs with musl on a "standard" glibc Linux system), -find whatever embarassing bugs I've let slip through, and provide -feedback on issues encountered building various software against musl. - -Please visit #musl on Freenode IRC or contact me via email at dalias -AT etalabs DOT net for bug reports, support requests, or to get -involved in development. As this has been a one-person project so far, -mailing lists will be setup in due time on an as-needed basis. - -Thank you for trying out musl. +Please refer to the COPYRIGHT file for details on the copyright and +license status of code included in musl (standard MIT license). + + + +Greetings! + +With the 0.9.0 release, musl has reached a milestone in completeness +and compatibility. All interfaces in ISO C99 and POSIX 2008 base exist +in musl, along with a number of non-standardized interfaces based on +GNU and BSD libraries and syscall interfaces for Linux-kernel-specific +functions. Some interfaces lack obscure or rarely-used functionality +needed for strict conformance, but the vast majority of interfaces go +above and beyond the requirements for conformance, often promising +success where other implementations can fail under resource exhaustion +or other corner-case conditions. + +At this point, hundreds of packages have been successfully built +against musl - either out-of-the-box or with minor patches to address +portability errors - ranging from low-level system utilities and +network daemons to major gui applications. Testing has been conducted +using three separate test frameworks and numerous additional +standalone test cases to verify the correctness of the implementation. + +Included with this package is a gcc wrapper script (musl-gcc) which +allows you to build musl-linked programs using an existing gcc 3.x or +4.x toolchain on the host. There are also now at several mini +distributions (in the form of build scripts) which provide a +self-hosting musl-based toolchain and system root. These are much +better options than the wrapper script if you wish to use dynamic +linking or build packages with many library dependencies. See the musl +website for details. + +The musl project is actively seeking contributors, mostly in the areas +of porting, testing, and application compatibility improvement. For +bug reports, support requests, or to get involved in development, +please visit #musl on Freenode IRC or subscribe to the musl mailing +list by sending a blank email to musl-subscribe AT lists DOT openwall +DOT com. + +Thank you for using musl. Cheers,