README
This directory contains the source code for the Setup program
for the Cygwin net releases.
HOW TO BUILD:
-------------
Cygwin
------
Setup should build out-of-the-box on any Cygwin environment that has all the
required packages and their dependencies installed:
- autoconf
- automake
- bison
- flex
- libtool
- make
- mingw64-${arch}-bzip2
- mingw64-${arch}-gcc-g++
- mingw64-${arch}-headers
- mingw64-${arch}-libgcrypt
- mingw64-${arch}-libsolv
- mingw64-${arch}-xz
- mingw64-${arch}-zlib
- mingw64-${arch}-zstd
- upx (optional)
The ${arch} needs to be replaced with either "i686" or "x86_64"
depending on the target architecture to build for.
Fedora
------
Setup should also build out-of-the-box in a Fedora environment that has all the
required packages and their dependencies installed:
- automake
- bison
- flex
- libtool
- make
- mingw${arch}-bzip2-static
- mingw${arch}-gcc-c++
- mingw${arch}-libgcrypt-static
- mingw${arch}-libgnurx-static
- mingw${arch}-libsolv-static (*)
- mingw${arch}-winpthreads-static
- mingw${arch}-xz-libs-static
- mingw${arch}-zlib-static
- mingw${arch}-zstd-static (**)
- upx (optional)
The ${arch} needs to be replaced with either "32" or "64"
depending on the target architecture to build for.
(*) Requires 'dnf copr enable jturney/mingw-libsolv'
(**) Requires 'dnf copr enable jturney/mingw-zstd'
Build commands:
0) Obtain this project's source code:
$ git clone git://sourceware.org/git/cygwin-apps/setup.git
$ cd setup
1) Configure using this option
$ /path/to/setup/bootstrap.sh
This will automatically rebuild configure files and run configure
in the current directory. If you have installed toolchains for
both i686 and x86_64 architectures, then you need to select for
which architecture you want to build:
$ /path/to/setup/bootstrap.sh --host=i686-w64-mingw32
$ /path/to/setup/bootstrap.sh --host=x86_64-w64-mingw32
2) $ make
3) Wondering why your binary is so much bigger than the official releases?
This removes debugging symbols:
$ make strip
This additionally compresses it using UPX
(requires package upx to be installed):
$ make upx
CODING GUIDELINES:
------------------
setup has a number of different code formats in it. This is ok as long
as it stays readable. When submitting a patch, make sure that you use
the coding-style of the surrounding code.
For new code, use the GNU standards as much as possible. We understand
that this is not a precise fit for C++ code but you can use Cygwin itself
as a guide.
SUBMITTING A PATCH:
-------------------
Follow the general directions given in the Cygwin contributions document:
https://cygwin.com/contrib.html
The appropriate mailing list for this project is cygwin-apps
(rather than cygwin-patches). Thus an appropriate configuration is:
$ git config --local format.subjectprefix "PATCH setup"
$ git config --local sendemail.to "cygwin-apps@cygwin.com"
Before sending patches with:
$ git format-patch [--cover-letter]
$ git send-email *.patch
TRANSLATIONS
------------
Translations of the gettext template res.pot can be made using PO file tools, or
online at https://hosted.weblate.org/projects/cygwin-setup/cygwin-setup/
Cached version (6606s old)