X-Git-Url: http://nsz.repo.hu/git/?p=musl;a=blobdiff_plain;f=README;h=db9726a3ea2b133ead89578ee028b2f60bf11c4f;hp=a57541c6755bbead67de9cb0eba50354476eed47;hb=2adf2fb372745a406544188029d3f769f71a9f2c;hpb=0b44a0315b47dd8eced9f3b7f31580cf14bbfc01 diff --git a/README b/README index a57541c6..db9726a3 100644 --- a/README +++ b/README @@ -18,24 +18,35 @@ 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. +Greetings! + +As of the 0.8.0 release, musl is in _beta_ status. While some +interfaces remain incomplete or yet to be implemented, the ABI is +intended to be stable at this point, and serious efforts have been +made, using three separate test frameworks, to verify the correctness +of the implementation. Many major system-level and user-level programs +are known to work with musl, either out-of-the-box or with minor +patches to address portability errors; the main remaining applications +which definitely will not work are those which require C++ support, +which will be addressed during the 0.8 or 0.9 development series. + +Included with this package is a gcc wrapper script (musl-gcc) which +allows you to build musl-linked programs using an existing gcc 4.x +toolchain on the host. There are also now at least two mini +distributions (in the form of build scripts) which provide a +self-hosting musl-based toolchain and system root: Sabotage Linux and +Bootstrap Linux. These are much better options than the wrapper script +if you wish to use dynamic linking or build packages with many library +dependencies. + +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,