diff options
| -rw-r--r-- | winsup/README | 9 | ||||
| -rw-r--r-- | winsup/doc/ChangeLog | 5 | ||||
| -rw-r--r-- | winsup/doc/faq-programming.xml | 44 |
3 files changed, 32 insertions, 26 deletions
diff --git a/winsup/README b/winsup/README new file mode 100644 index 0000000..290275c --- /dev/null +++ b/winsup/README @@ -0,0 +1,9 @@ +THIS SOFTWARE IS PROVIDED ``AS IS'' AND WITHOUT ANY EXPRESS OR +IMPLIED WARRANTIES, INCLUDING, WITHOUT LIMITATION, THE IMPLIED +WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE. + +Cygwin documentation is available on the net at http://cygwin.com +You might especially be interested in + +http://cygwin.com/faq/faq.programming.html#faq.programming.building-cygwin + diff --git a/winsup/doc/ChangeLog b/winsup/doc/ChangeLog index d470198..06250ab 100644 --- a/winsup/doc/ChangeLog +++ b/winsup/doc/ChangeLog @@ -1,5 +1,10 @@ 2006-01-26 Joshua Daniel Franklin <joshuadfranklin@yahoo.com> + * faq-programming.xml (faq.programming.building-cygwin): + Simplify instructions, and remove tar usage basics. + +2006-01-26 Joshua Daniel Franklin <joshuadfranklin@yahoo.com> + * faq-programming.xml (faq.programming.ipc): Add new FAQ about cygserver and its relation to the "Bad system call" error. * faq-setup.xml (faq.setup.uninstall-all): Mention postgresql. diff --git a/winsup/doc/faq-programming.xml b/winsup/doc/faq-programming.xml index 2f3d9c1..d4035a5 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, |