https://sourceware.org/git/gitweb.cgi?p=newlib-cygwin.git;h=4d83d657388387443ab908e706bebe09d1fecfac
commit 4d83d657388387443ab908e706bebe09d1fecfac Author: Jon Turney <[email protected]> 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>
