[newlib-cygwin/main] Cygwin: Update the "building cygwin" FAQ
Jon Turney
jturney@sourceware.org
Fri Dec 19 11:46:31 GMT 2025
https://sourceware.org/git/gitweb.cgi?p=newlib-cygwin.git;h=4d83d657388387443ab908e706bebe09d1fecfac
commit 4d83d657388387443ab908e706bebe09d1fecfac
Author: Jon Turney <jon.turney@dronecode.org.uk>
Date: Thu Jun 5 12:14:37 2025 +0100
Cygwin: Update the "building cygwin" FAQ
Shorten the example path for clarity.
Using --prefix rather than DESTDIR to select the install location is
generically wrong (and specifically wrong because it causes an
incorrectly prefixed /etc/cygserver.conf path to be baked into the
cygserver built).
Install using -j1 because... cygwin's install rules overwrite things
installed by newlib, so running those in parallel can have undesired
results. (something something tooldir something something)
Diff:
---
winsup/doc/faq-programming.xml | 22 +++++++++++-----------
1 file changed, 11 insertions(+), 11 deletions(-)
diff --git a/winsup/doc/faq-programming.xml b/winsup/doc/faq-programming.xml
index 696a6462b..ac361839a 100644
--- a/winsup/doc/faq-programming.xml
+++ b/winsup/doc/faq-programming.xml
@@ -747,20 +747,20 @@ download the corresponding source package
<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 to
-<literal>/oss/src/newlib-cygwin/</literal>, and you want to install to the
-temporary location <literal>/oss/install/</literal>, these are the required
+<literal>/src/newlib-cygwin/</literal>, and you want to install to the
+temporary location <literal>/install/</literal>, these are the required
steps to build Cygwin:
</para>
+
<screen>
-$ mkdir -p /oss/src/newlib-cygwin/build # create build dir
-$ mkdir -p /oss/install # create install dir
-$ cd /oss/src/newlib-cygwin/winsup # chdir into Cygwin source dir and...
-$ ./autogen.sh # create config files
-$ cd /oss/src/newlib-cygwin/build # chdir into build dir
-$ # create makefiles...
-$ /oss/src/newlib-cygwin/configure --prefix=/oss/install
-$ make # build Cygwin
-$ make install # install Cygwin into install dir
+$ mkdir -p /src/newlib-cygwin/build # create build dir
+$ mkdir -p /install # create install dir
+$ cd /src/newlib-cygwin/winsup # chdir into Cygwin source dir and...
+$ ./autogen.sh # create config files
+$ cd /src/newlib-cygwin/build # chdir into build dir
+$ /src/newlib-cygwin/configure # create makefiles...
+$ make # build Cygwin
+$ make -j1 install DESTDIR=/install # install Cygwin into install dir
</screen>
<para>
More information about the Cygwin-cvs
mailing list