From 9acf46c0c74008440f6dfc4d09d82934a56ecd18 Mon Sep 17 00:00:00 2001
From: Eric Andersen <andersen@codepoet.org>
Date: Wed, 12 Jan 2005 07:52:50 +0000
Subject: Update docs for release

---
 docs/uclibc.org/FAQ.html        |  37 +++++++------
 docs/uclibc.org/news.html       | 117 ++++++---------------------------------
 docs/uclibc.org/oldnews.html    | 114 ++++++++++++++++++++++++++++++++++++++
 docs/uclibc.org/toolchains.html | 120 ++++++++++++++++++++++++++--------------
 4 files changed, 230 insertions(+), 158 deletions(-)

(limited to 'docs/uclibc.org')

diff --git a/docs/uclibc.org/FAQ.html b/docs/uclibc.org/FAQ.html
index 4f611f647..197511d27 100644
--- a/docs/uclibc.org/FAQ.html
+++ b/docs/uclibc.org/FAQ.html
@@ -227,7 +227,7 @@ How could it be smaller and not suck?</a></h2>
     You will need to have your own uClibc toolchain.  A toolchain consists
     of <a href="http://sources.redhat.com/binutils/">GNU binutils</a>,
     <a href="http://gcc.gnu.org/">the gcc compiler</a>, and uClibc, all
-    built to produce binaries linked with uClibc for your target system.
+    built to produce binaries for your target system linked with uClibc.
     You can build your own native uClibc toolchain using the
     <a href="/cgi-bin/cvsweb/buildroot/">uClibc buildroot system</a>.
 
@@ -314,17 +314,13 @@ How could it be smaller and not suck?</a></h2>
     without needing to compile your own toolchain or anything, you can grab a
     pre-compiled uClibc development system.  These are currently available for
 
-    <a href="http://www.kernel.org/pub/linux/libs/uclibc/root_fs_i386.bz2">i386</a>,
-    <a href="http://www.kernel.org/pub/linux/libs/uclibc/root_fs_powerpc.bz2">powerpc</a>,
-    <a href="http://www.kernel.org/pub/linux/libs/uclibc/root_fs_arm.bz2">arm</a>,
-    <a href="http://www.kernel.org/pub/linux/libs/uclibc/root_fs_mips.bz2">mips</a>,
-    <a href="http://www.kernel.org/pub/linux/libs/uclibc/root_fs_mipsel.bz2">mipsel</a>, and
-    <a href="http://www.kernel.org/pub/linux/libs/uclibc/root_fs_sh4.bz2">sh4</a>.
-
-    <p>
-
-    Each of these uClibc development systems was created using
-    <a href="/cgi-bin/cvsweb/buildroot/">buildroot</a>.
+    <a href="http://www.uclibc.org/downloads/root_fs_arm.ext2.bz2">arm</a>,
+    <a href="http://www.uclibc.org/downloads/root_fs_armeb.ext2.bz2">armeb</a>,
+    <a href="http://www.uclibc.org/downloads/root_fs_i386.ext2.bz2">i386</a>,
+    <a href="http://www.uclibc.org/downloads/root_fs_mips.ext2.bz2">mips</a>,
+    <a href="http://www.uclibc.org/downloads/root_fs_mipsel.ext2.bz2">mipsel</a>,
+    <a href="http://www.uclibc.org/downloads/root_fs_powerpc.ext2.bz2">powerpc</a>, and
+    <a href="http://www.uclibc.org/downloads/root_fs_sh4.ext2.bz2">sh4</a>.
 
     <p>
 
@@ -335,11 +331,18 @@ How could it be smaller and not suck?</a></h2>
 
     <p>
 
-    This should be pretty much everything you need to get started building your
-    own applications with uClibc.  Once you download one of these systems, you
-    can then boot into it, loop mount it, dd it to a spare drive and use a tool
-    such as resize2fs to make it fill a partition...  Whatever works best for
-    you.
+    Each of these uClibc development systems was created using
+    <a href="/cgi-bin/cvsweb/buildroot/">buildroot</a>, specifically,
+    <a href="http://www.uclibc.org/downloads/buildroot.tar.bz2">buildroot.tar.bz2</a>
+    along with <a href="http://www.uclibc.org/downloads/buildroot-sources">these sources</a>.
+
+    <p>
+
+    These development systems should provide pretty much everything you need to get
+    started building your own applications with uClibc.  Once you download one of
+    these systems, you can then boot into it, loop mount it, dd it to a spare drive
+    and use a tool such as resize2fs to make it fill a partition...  Whatever works
+    best for you.
 
     <p>
     The quickest way to get started using a root_fs image (using the i386
diff --git a/docs/uclibc.org/news.html b/docs/uclibc.org/news.html
index d0387081b..2f0b4ec32 100644
--- a/docs/uclibc.org/news.html
+++ b/docs/uclibc.org/news.html
@@ -3,122 +3,37 @@
 
 <ul>
 
-    <li> <b>20 April 2004, uClibc 0.9.26 based Debian uwoody</b>
+    <li> <b>12 January 2005, uClibc 0.9.27 Released</b>
     <br>
 
-    CodePoet Consulting (i.e. Erik) is pleased to announce the immediate
-    availability of an x86 port of Debian woody compiled with uClibc 0.9.26.
-    This was originally announced a couple of months ago, but has been updated
-    a few times since to correct several small problems.  If you want an easy
-    way to start building your own uClibc based applications, this is it.  This
-    even supports building your own packages using 'apt-get', and using
-    'apt-get' to install already compiled packages from uclibc.org.  You can
-    find Erik's uwoody distribution <a
-    href="http://www.uclibc.org/dists/">uwoody distribution here</a>.  Assembling
-    this Debian/uClibc system required a <em>lot</em> of work, so if you
-    think this is the coolest thing since the invention of water, feel free to
-    <a href="http://uclibc.org/FAQ.html#support">let us know</a>.
-
-
-    <p>
-    <li> <b>3 January 2004, uClibc 0.9.26 Released</b>
-    <br>
-
-    CodePoet Consulting is sorry to announce there was a pthread bug that
-    slipped though our extensive testing and was only noticed a few hours after
-    the previous release.  As a result, we are now releasing uClibc 0.9.26
-    which fixes this bug, and is otherwise identical to the previous release.
-
-    <p>
-
-    This release remains binary compatible with uClibc 0.9.21-25, as long as
-    you take care to avoid any configuraton changes that will break things.
-    Please be aware we <b>will</b> break binary compatibilty in the upcoming
-    0.9.27 release to implement a few necessary changes we have been
-    postponing.  That will hopefully be the last ABI change before we freeze
-    the ABI for the upcoming 1.0.x stable uClibc series.
-
-    <p>
-
-    As usual, the
-    <a href="http://www.uclibc.org/downloads/Changelog">Changelog</a>,
-    <a href="http://www.uclibc.org/downloads/Changelog.full">detailed changelog</a>,
-    and <a href="http://www.uclibc.org/downloads/uClibc-0.9.26.tar.bz2">source code for this release</a>
-    are available <a href="http://www.uclibc.org/downloads/">here</a>.
-
-
-    <li> <b>3 January 2004, uClibc 0.9.25 Released</b>
-    <br>
-
-    CodePoet Consulting is pleased to announce the immediate availability of
-    uClibc 0.9.25.  This contains many bug fixes and cleanups, and is
-    recommended for anyone using uClibc.  This release remains binary
-    compatible with uClibc 0.9.21-24 (as long as you take care to avoid any
-    configuraton changes that will break things).  We <b>were</b> planning to break
-    binary compatibilty in this release, but decided to hold those changes so
-    we could push out a bugfix release.
+    This has been a long time in the making...  Release highlights:
+    <ul>
+	<li> New stdio implementation
+	<li> New optimized string functions
+	<li> Major improvements to the shared lib loader
+	<li> Shared libraries work properly on powerpc
+	<li> Debugging works on mips
+	<li> New architectures: frv, nios, nios2, bfin
+	<li> Linux 2.6.x kernel support
+	<li> Lots and lots of bug fixes
+    </ul>
 
     <p>
 
-    Please be aware we <b>will</b> break binary compatibilty in the upcoming
-    0.9.26 release to implement a few changes we have been postponing.  That
-    will hopefully be the last ABI change before we freeze the ABI for the
-    upcoming 1.0.x stable uClibc series.
+    This release is NOT binary compatible with uClibc 0.9.26 or any earlier
+    release, so be prepared to recompile your software if you are still using
+    an old version of uClibc.
 
     <p>
 
     As usual, the
     <a href="http://www.uclibc.org/downloads/Changelog">Changelog</a>,
     <a href="http://www.uclibc.org/downloads/Changelog.full">detailed changelog</a>,
-    and <a href="http://www.uclibc.org/downloads/uClibc-0.9.25.tar.bz2">source code for this release</a>
+    and <a href="http://www.uclibc.org/downloads/uClibc-0.9.27.tar.bz2">source code for this release</a>
     are available <a href="http://www.uclibc.org/downloads/">here</a>.
 
 
-    <p>
-    <li> <b>19 December 2003, dev systems updated to uClibc 0.9.24</b>
-    <br>
-
-    Current uClibc development systems have been posted for
-    <a href="http://www.kernel.org/pub/linux/libs/uclibc/root_fs_i386.bz2">i386</a>,
-    <a href="http://www.kernel.org/pub/linux/libs/uclibc/root_fs_powerpc.bz2">powerpc</a>,
-    <a href="http://www.kernel.org/pub/linux/libs/uclibc/root_fs_arm.bz2">arm</a>,
-    <a href="http://www.kernel.org/pub/linux/libs/uclibc/root_fs_mips.bz2">mips</a>,
-    <a href="http://www.kernel.org/pub/linux/libs/uclibc/root_fs_mipsel.bz2">mipsel</a>, and
-    <a href="http://www.kernel.org/pub/linux/libs/uclibc/root_fs_sh4.bz2">sh4</a>.
-    The powerpc dev system mostly works, but there are still some 
-    problems with the shared library loader that have not yet been resolved.
-    Details on what these are and how to use them can be found in the
-    <a href="/FAQ.html#dev_systems">FAQ</a>
-
-
-    <p>
-    <li> <b>15 December 2003, uClibc 0.9.24 Released</b>
-    <br>
-
-    CodePoet Consulting is pleased to announce the immediate availability of
-    uClibc 0.9.24.  This contains various minor updates and fixes for a few
-    silly configuration problems.  Arm users should notice a speed increase
-    since some arm optimized string functions have been added.  And several
-    bugs have been fixed.
-
-    <p>
-
-    This release continues to be binary compatible with uClibc 0.9.21 to 0.9.23
-    -- as long as you pick compatible configuration options.  The next release
-    will <b>not</b> be binary compatible.  We've been saving up a few needed
-    changes that will be going into the next release, so while you will not
-    need to recompile all your applications and libraries just yet, keep in
-    mind we will have a flag day soon...
-
-    <p>
-
-    As usual, the 
-    <a href="http://www.uclibc.org/downloads/Changelog">Changelog</a>, 
-    <a href="http://www.uclibc.org/downloads/Changelog.full">detailed changelog</a>, 
-    and <a href="http://www.uclibc.org/downloads/uClibc-0.9.24.tar.bz2">source code for this release</a> 
-    are available <a href="http://www.uclibc.org/downloads/">here</a>.
 
-    
     <p> <li> <b>Old News</b>
     <br>
     <a href="/oldnews.html">Click here to read older news</a>
diff --git a/docs/uclibc.org/oldnews.html b/docs/uclibc.org/oldnews.html
index bd67e712d..08fb47e24 100644
--- a/docs/uclibc.org/oldnews.html
+++ b/docs/uclibc.org/oldnews.html
@@ -4,6 +4,120 @@
 <ul>
 
 
+    <li> <b>20 April 2004, uClibc 0.9.26 based Debian uwoody</b>
+    <br>
+
+    CodePoet Consulting (i.e. Erik) is pleased to announce the immediate
+    availability of an x86 port of Debian woody compiled with uClibc 0.9.26.
+    This was originally announced a couple of months ago, but has been updated
+    a few times since to correct several small problems.  If you want an easy
+    way to start building your own uClibc based applications, this is it.  This
+    even supports building your own packages using 'apt-get', and using
+    'apt-get' to install already compiled packages from uclibc.org.  You can
+    find Erik's uwoody distribution <a
+    href="http://www.uclibc.org/dists/">uwoody distribution here</a>.  Assembling
+    this Debian/uClibc system required a <em>lot</em> of work, so if you
+    think this is the coolest thing since the invention of water, feel free to
+    <a href="http://uclibc.org/FAQ.html#support">let us know</a>.
+
+
+    <p>
+    <li> <b>3 January 2004, uClibc 0.9.26 Released</b>
+    <br>
+
+    CodePoet Consulting is sorry to announce there was a pthread bug that
+    slipped though our extensive testing and was only noticed a few hours after
+    the previous release.  As a result, we are now releasing uClibc 0.9.26
+    which fixes this bug, and is otherwise identical to the previous release.
+
+    <p>
+
+    This release remains binary compatible with uClibc 0.9.21-25, as long as
+    you take care to avoid any configuraton changes that will break things.
+    Please be aware we <b>will</b> break binary compatibilty in the upcoming
+    0.9.27 release to implement a few necessary changes we have been
+    postponing.  That will hopefully be the last ABI change before we freeze
+    the ABI for the upcoming 1.0.x stable uClibc series.
+
+    <p>
+
+    As usual, the
+    <a href="http://www.uclibc.org/downloads/Changelog">Changelog</a>,
+    <a href="http://www.uclibc.org/downloads/Changelog.full">detailed changelog</a>,
+    and <a href="http://www.uclibc.org/downloads/uClibc-0.9.26.tar.bz2">source code for this release</a>
+    are available <a href="http://www.uclibc.org/downloads/">here</a>.
+
+
+    <li> <b>3 January 2004, uClibc 0.9.25 Released</b>
+    <br>
+
+    CodePoet Consulting is pleased to announce the immediate availability of
+    uClibc 0.9.25.  This contains many bug fixes and cleanups, and is
+    recommended for anyone using uClibc.  This release remains binary
+    compatible with uClibc 0.9.21-24 (as long as you take care to avoid any
+    configuraton changes that will break things).  We <b>were</b> planning to break
+    binary compatibilty in this release, but decided to hold those changes so
+    we could push out a bugfix release.
+
+    <p>
+
+    Please be aware we <b>will</b> break binary compatibilty in the upcoming
+    0.9.26 release to implement a few changes we have been postponing.  That
+    will hopefully be the last ABI change before we freeze the ABI for the
+    upcoming 1.0.x stable uClibc series.
+
+    <p>
+
+    As usual, the
+    <a href="http://www.uclibc.org/downloads/Changelog">Changelog</a>,
+    <a href="http://www.uclibc.org/downloads/Changelog.full">detailed changelog</a>,
+    and <a href="http://www.uclibc.org/downloads/uClibc-0.9.25.tar.bz2">source code for this release</a>
+    are available <a href="http://www.uclibc.org/downloads/">here</a>.
+
+
+    <p>
+    <li> <b>19 December 2003, dev systems updated to uClibc 0.9.24</b>
+    <br>
+
+    Current uClibc development systems have been posted for
+    <a href="http://www.kernel.org/pub/linux/libs/uclibc/root_fs_i386.bz2">i386</a>,
+    <a href="http://www.kernel.org/pub/linux/libs/uclibc/root_fs_powerpc.bz2">powerpc</a>,
+    <a href="http://www.kernel.org/pub/linux/libs/uclibc/root_fs_arm.bz2">arm</a>,
+    <a href="http://www.kernel.org/pub/linux/libs/uclibc/root_fs_mips.bz2">mips</a>,
+    <a href="http://www.kernel.org/pub/linux/libs/uclibc/root_fs_mipsel.bz2">mipsel</a>, and
+    <a href="http://www.kernel.org/pub/linux/libs/uclibc/root_fs_sh4.bz2">sh4</a>.
+    The powerpc dev system mostly works, but there are still some 
+    problems with the shared library loader that have not yet been resolved.
+    Details on what these are and how to use them can be found in the
+    <a href="/FAQ.html#dev_systems">FAQ</a>
+
+
+    <p>
+    <li> <b>15 December 2003, uClibc 0.9.24 Released</b>
+    <br>
+
+    CodePoet Consulting is pleased to announce the immediate availability of
+    uClibc 0.9.24.  This contains various minor updates and fixes for a few
+    silly configuration problems.  Arm users should notice a speed increase
+    since some arm optimized string functions have been added.  And several
+    bugs have been fixed.
+
+    <p>
+
+    This release continues to be binary compatible with uClibc 0.9.21 to 0.9.23
+    -- as long as you pick compatible configuration options.  The next release
+    will <b>not</b> be binary compatible.  We've been saving up a few needed
+    changes that will be going into the next release, so while you will not
+    need to recompile all your applications and libraries just yet, keep in
+    mind we will have a flag day soon...
+
+    <p>
+
+    As usual, the 
+    <a href="http://www.uclibc.org/downloads/Changelog">Changelog</a>, 
+    <a href="http://www.uclibc.org/downloads/Changelog.full">detailed changelog</a>, 
+    and <a href="http://www.uclibc.org/downloads/uClibc-0.9.24.tar.bz2">source code for this release</a> 
+    are available <a href="http://www.uclibc.org/downloads/">here</a>.
     <li> <b>13 November 2003, uClibc 0.9.23 Released</b>
     <br>
 
diff --git a/docs/uclibc.org/toolchains.html b/docs/uclibc.org/toolchains.html
index 132270b6b..852096af9 100644
--- a/docs/uclibc.org/toolchains.html
+++ b/docs/uclibc.org/toolchains.html
@@ -2,51 +2,91 @@
 
 
 <h3>Toolchains</h3>
-To use uClibc, you need to have a toolchain, which is composed
-of <a href="http://sources.redhat.com/binutils/">binutils</a>, 
-<a href="http://gcc.gnu.org/">gcc</a>, and of course uClibc.
+To use uClibc, you need to have a toolchain.  A toolchain consists
+of <a href="http://sources.redhat.com/binutils/">GNU binutils</a>,
+<a href="http://gcc.gnu.org/">the gcc compiler</a>, and uClibc, all
+built to produce binaries for your target system linked with uClibc.
+You can build your own native uClibc toolchain using the
+<a href="/cgi-bin/cvsweb/buildroot/">uClibc buildroot system</a>.
 
+<p>
+To build your own uClibc toolchain, follow the following simple
+steps:
 <ul>
+    <li> Point your web browser <a href="/cgi-bin/cvsweb/buildroot/">here</a>,
+    <li> Click on "Download tarball"
+    <li> Unpack the tarball on your Linux system somewhere
+    <li> Edit the Makefile as needed if you wish to change anything.
+    <li> run 'unset CC'.   Then run 'unset CXX'.  Some Linux systems
+	(i.e. Gentoo) set variables such as 'CC' in the system environment
+	which really messes things up when cross compiling.
+    <li> run 'make menuconfig'
+    <li> Select the things you want to build.  If you <em>only</em> want a
+	toolchain, leave everything except the toolchain disabled.
+    <li> save your buildroot configuration.
+    <li> run 'make'
+    <li> go eat a nice loose meat sandwich, drink a pop, call a friend,
+	play a video game, and generally find something to do.  While you
+	are waiting, buildroot will download all the needed source code and
+	then compile things up for you.
+    <li> You should now have a shiny new toolchain, and maybe even a shiny
+	new uClibc based root filesystem or development system, depending on
+	the options you selected.
+</ul>
+
+
+
+
+<p>
+
+If you want to be <em>really</em> lazy and start using uClibc right away
+without needing to compile your own toolchain or anything, you can grab a
+pre-compiled uClibc development system.  These are currently available for
+
+<a href="http://www.uclibc.org/downloads/root_fs_arm.ext2.bz2">arm</a>,
+<a href="http://www.uclibc.org/downloads/root_fs_armeb.ext2.bz2">armeb</a>,
+<a href="http://www.uclibc.org/downloads/root_fs_i386.ext2.bz2">i386</a>,
+<a href="http://www.uclibc.org/downloads/root_fs_mips.ext2.bz2">mips</a>,
+<a href="http://www.uclibc.org/downloads/root_fs_mipsel.ext2.bz2">mipsel</a>,
+<a href="http://www.uclibc.org/downloads/root_fs_powerpc.ext2.bz2">powerpc</a>, and
+<a href="http://www.uclibc.org/downloads/root_fs_sh4.ext2.bz2">sh4</a>.
 
-    <li>You can build your own 
-	<a href="/cgi-bin/cvsweb/toolchain/gcc-3.3.x/">uClibc toolchain</a>
-	using this to automagically download all the needed source code
-	and compile everything for you.
-    <p> 
-
-    <li>Steven J. Hill has kindly provided 
-	<a href="ftp://ftp.realitydiluted.com/linux/MIPS/toolchains">RPMs and SRPMs</a>
-	with toolchains for mips.
-    <p> 
-
-    <li>You can compile your own uClibc development system using
-	<a href="/cgi-bin/cvsweb/buildroot/">buildroot</a>.
-    <p> 
-
-    <li>Prebuilt uClibc development systems for
-	<a href="http://www.kernel.org/pub/linux/libs/uclibc/root_fs_i386.bz2">i386</a>
-	and
-	<a href="http://www.kernel.org/pub/linux/libs/uclibc/root_fs_arm.bz2">arm</a>
-	and 
-	<a href="http://www.kernel.org/pub/linux/libs/uclibc/root_fs_mipsel.bz2">mipsel</a>
-	are available and contain complete native gcc 3.3.2 toolchains.  These
-	are development systems are ext2 filesystems that runs natively on the
-	specified architecture.  They contain all the development software you
-	need to build your own uClibc applications, including bash, coreutils,
-	findutils, diffutils, patch, sed, ed, flex, bison, file, gawk, tar,
-	grep gdb, strace, make, gcc, g++,  autoconf, automake, ncurses, zlib,
-	openssl, openssh perl, and more.   And of course, everything is
-	dynamically linked against uClibc.  By using a uClibc only system, you
-	can avoid all the painful cross-configuration problems that have made
-	using uClibc somewhat painful in the past.  If you want to quickly get
-	started with testing or using uClibc you should give these images a
-	try.  You can loop mount them and then chroot into them.  You can boot
-	into them using user-mode Linux.  You can even 'dd' them to a spare
-	partition and use resize2fs to make them fill the drive, and then boot
-	into them.  Whatever works for you.
-    <p> 
+<p>
 
+These are bzip2 compressed ext2 filesystems containing all the development
+software you need to build your own uClibc applications, including: bash, awk,
+make, gcc, g++, autoconf, automake, ncurses, zlib, openssl, openssh, gdb,
+strace, busybox, GNU coreutils, GNU tar, GNU grep, etc.
+
+<p>
+
+Each of these uClibc development systems was created using
+<a href="/cgi-bin/cvsweb/buildroot/">buildroot</a>, specifically,
+<a href="http://www.uclibc.org/downloads/buildroot.tar.bz2">buildroot.tar.bz2</a>
+along with <a href="http://www.uclibc.org/downloads/buildroot-sources">these sources</a>.
+
+<p>
+
+These development systems should provide pretty much everything you need to get
+started building your own applications with uClibc.  Once you download one of
+these systems, you can then boot into it, loop mount it, dd it to a spare drive
+and use a tool such as resize2fs to make it fill a partition...  Whatever works
+best for you.
+
+<p>
+The quickest way to get started using a root_fs image (using the i386
+platform as an example) is:
+<ul>
+    <li>Download root_fs_i386.bz2 from kernel.org</li>
+    <li>bunzip2 root_fs_i386.bz2</li>
+    <li>mkdir root_fs</li>
+    <li>su root</li>
+    <li>mount -o loop root_fs_i386 root_fs</li>
+    <li>chroot root_fs /bin/su -</li>
 </ul>
+Type "exit" to end the chroot session and return to your host system.
+<p>
+
 
 <!--#include file="footer.html" -->
 
-- 
cgit v1.2.3