From f5e75095d0a40294a0cbff62b45759ecd8a1e485 Mon Sep 17 00:00:00 2001
From: "Yann E. MORIN\"" <yann.morin.1998@anciens.enib.fr>
Date: Mon, 9 Jul 2007 17:35:45 +0000
Subject: Update man page to explictly point to overview.txt. In overview.txt,
 document usage of the populate script.


diff --git a/docs/ct-ng.1.in b/docs/ct-ng.1.in
index fdf51e2..3c9b461 100644
--- a/docs/ct-ng.1.in
+++ b/docs/ct-ng.1.in
@@ -159,12 +159,16 @@ reordered
 (see section titled
 .BR "SEE ALSO" )
 scripts to be more easily maintainable, added the Kconfig configurator, some
-patches.
+patches, support for linux headers installation, and support for uClibc-based
+toolchains.
 
 Please consult the file
 .I @@CT_DOCDIR@@/CREDITS
 for a list of contributors.
 ."
 .SH SEE ALSO
+You can find more in-depth documentation in
+.IR @@CT_DOCDIR@@/overview.txt .
+
 Please have a look at the
 .URL "http://www.kegel.com/crosstool" "original crosstool" " by Daniel KEGEL"
diff --git a/docs/overview.txt b/docs/overview.txt
index a35d995..f49988d 100644
--- a/docs/overview.txt
+++ b/docs/overview.txt
@@ -206,6 +206,35 @@ Testing all toolchains at once |
 You can test-build all samples; simply call:
   ct-ng regtest
 
+_______________________
+                      /
+Using the toolchain  /
+____________________/
+
+Using the toolchain is as simple as adding the toolchain's bin directory in
+your PATH, such as:
+  export PATH="${PATH}:/your/toolchain/path/bin"
+
+and then using the target triplet to tell the build systems to use your
+toolchain:
+  ./configure --target=your-target-triplet
+  make CC=your-target-triplet-gcc
+  make CROSS_COMPILE=your-target-triplet-
+  and so on...
+
+When your root directory is ready, it is still missing some important bits: the
+toolchain's libraries. To populate your root directory with those libs, just
+run:
+  your-target-triplet-populate -s /your/root -d /your/root-populated
+
+This will copy /your/root into /your/root-populated, and put the needed and only
+the needed libraries there. Thus you don't polute /your/root with any cruft that
+would no longer be needed should you have to remove stuff. /your/root always
+contains only those things you install in it.
+
+You can then use /your/root-populated to build up your file system image, a
+tarball, or to NFS-mount it from your target, or whatever you need.
+
 ___________________
                   /
 Toolchain types  /
-- 
cgit v0.10.2-6-g49f6