From 1d027828bc40ab174404dc4150eb9b2ba78b3e22 Mon Sep 17 00:00:00 2001 From: cgf Date: Sun, 2 Jun 2002 06:18:53 +0000 Subject: [PATCH] * how-programming.texinfo: Add more words to the "how to build". --- winsup/doc/ChangeLog | 4 ++++ winsup/doc/how-programming.texinfo | 24 +++++++++++++++++------- 2 files changed, 21 insertions(+), 7 deletions(-) diff --git a/winsup/doc/ChangeLog b/winsup/doc/ChangeLog index 003f3903df..2e76ede2fc 100644 --- a/winsup/doc/ChangeLog +++ b/winsup/doc/ChangeLog @@ -1,3 +1,7 @@ +2002-06-02 Christopher Faylor + + * how-programming.texinfo: Add more words to the "how to build". + 2002-03-01 Christopher Faylor * overview.sgml: Fix 'more more' typo. diff --git a/winsup/doc/how-programming.texinfo b/winsup/doc/how-programming.texinfo index cd5f5c200c..aa23b186f8 100644 --- a/winsup/doc/how-programming.texinfo +++ b/winsup/doc/how-programming.texinfo @@ -233,11 +233,21 @@ rewriting the runtime library in question from specs... @subsection How do I rebuild the tools on my NT box? -@strong{Note:} You must build in a directory @emph{outside} the source -tree. +Install all required components in one directory (we'll call it /src). +Ideally, you should check out what you need from CVS (@file{http://cygwin.com/cvs.html}) but +otherwise, you can install the appropriate source packages from the +cygwin distribution. -Assuming that you have the src installed as /src, will build in -the directory /obj, and want to install the tools in /install: +As of this writing, you need to install at least the cygwin source +package and the w32api source package. + +It is possible that the cygwin source package may require a newer +version of the w32api package since the release of the packages is +not always in lock step (another reason to just use CVS). + +You @emph{must} build cygwin in a separate directory from the source. +So, create something like a /obj directory. You'll be performing +your build in that directory: @example bash @@ -247,9 +257,9 @@ make > make.log 2>&1 make install > install.log 2>&1 @end example -Normally, this will also attempt to build the documentation, which -additionally requires db2html, and possibly other tools, which are not -included in the Cygwin distribution. You can get db2html as part of +Normally, this procedure will also attempt to build the documentation, +which additionally requires db2html, and possibly other tools, which are +not included in the Cygwin distribution. You can get db2html as part of docbook, from @file{http://sources.redhat.com/docbook-tools/}. To check a cygwin1.dll, run "make check" in the winsup/cygwin directory. -- 2.11.0