diff options
author | Joshua Daniel Franklin <joshuadfranklin@yahoo.com> | 2006-01-27 08:37:13 +0300 |
---|---|---|
committer | Joshua Daniel Franklin <joshuadfranklin@yahoo.com> | 2006-01-27 08:37:13 +0300 |
commit | 90c01ac9dfb0ce6cc126e4977cf171a946c5728f (patch) | |
tree | 9c1237a7c56d5d655d0ce921f6a724cd48f83ac2 /winsup/doc/faq-programming.xml | |
parent | aba373611c04ddc713bc22499043f8f4286abf1e (diff) |
Add top-level README
Diffstat (limited to 'winsup/doc/faq-programming.xml')
-rw-r--r-- | winsup/doc/faq-programming.xml | 44 |
1 files changed, 18 insertions, 26 deletions
diff --git a/winsup/doc/faq-programming.xml b/winsup/doc/faq-programming.xml index 2f3d9c1e7..d4035a5ad 100644 --- a/winsup/doc/faq-programming.xml +++ b/winsup/doc/faq-programming.xml @@ -438,44 +438,36 @@ rewriting the runtime library in question from specs... <para>First, you need to make sure you have the necessary build tools installed; you at least need <literal>gcc</literal>, <literal>make</literal>, -and <literal>perl</literal>. If you want to run the tests +and <literal>perl</literal>. If you want to run the tests, <literal>cocom</literal> and <literal>dejagnu</literal> are also required, and you need to have <literal>CYGWIN=server</literal> set as described at <ulink url="http://www.cygwin.com/cygwin-ug-net/using-cygserver.html" />. +Normally, building ignores any errors in building the documentation, +which requires the <literal>docbook-xml42</literal>, <literal>docbook-xsl</literal>, and +<literal>xmlto</literal> packages. For more information on building the +documentation, see the README included in the <literal>cygwin-doc</literal> package. +</para> -Next, get the Cygwin source. Ideally, you should check out +<para>Next, get the Cygwin source. Ideally, you should check out what you need from CVS (<ulink url="http://cygwin.com/cvs.html" />). This is the -<emphasis>preferred method</emphasis> for acquiring the sources. Otherwise, you can -install the cygwin source package from the distribution. -</para> -<para>If you are trying to duplicate a cygwin release then you should just -download the corresponding source package and use "tar xjf" to unpack -it. This will unpack the sources into a directory named cygwin-x.y.z-n, -where x.y.z-n correspond to the version numbering of the tar.bz2 -package. -</para> -<screen> -tar xjf cygwin-1.5.12-1-src.tar.bz2 -cd cygwin-1.5.12-1 -</screen> +<emphasis>preferred method</emphasis> for acquiring the sources. Otherwise, if +you are trying to duplicate a cygwin release then you should +download the corresponding source package +(<literal>cygwin-x.y.z-n-src.tar.bz2</literal>). </para> -<para>You <emphasis>must</emphasis> build cygwin in a separate directory from the source, -so create something like a <literal>build/</literal> directory. You will also want -to install to a temporary location: +<para>You <emphasis>must</emphasis> build cygwin in a separate directory from +the source, so create something like a <literal>build/</literal> directory. +Assuming you checked out the source in <literal>/oss/src/</literal>, and you +also want to install to the temporary location <literal>install</literal>: </para> <screen> -mkdir build -mkdir /install +mkdir /oss/build +mkdir /oss/install cd build -(../configure --prefix=/install -v; make) >& make.out +(/oss/src/configure --prefix=/oss/install -v; make) >& make.out make install > install.log 2>&1 </screen> -<para>Normally, this procedure ignores errors in building the documentation. -which requires the <literal>docbook-xml42</literal>, <literal>docbook-xsl</literal>, and -<literal>xmlto</literal> packages. For more information on building the -documentation, see the README included in the <literal>cygwin-doc</literal> package. -</para> <para>To check a cygwin1.dll, run "make check" in the winsup/testsuite directory. If that works, install everything <emphasis>except</emphasis> the dll (if you can). Then, close down all cygwin programs (including bash windows, |