rubyinstaller-build 0.1.0

checksums.yaml

@@ -0,0 +1,7 @@
+---
+SHA256:
+  metadata.gz: dba756e114c6f8871c36810f21e5adc58719ca68e4e698139b59b70f18109ead
+  data.tar.gz: 24af26b82e2e7cff07240e21bcd0c17871039a59785c8b4e5527ac8385a87acb
+SHA512:
+  metadata.gz: 66393a5b050b961ad64336bf97fc0dea5dc7af18fbd0c7ce70b2ba2f9615fede242e5260d7a43dede83a690701c9be15f1d66ffd27a329ee371ec930966e9b74
+  data.tar.gz: dc2ca43ee1abb10b2030ca54301a4b7a8b902040effb1fd88286b8c38ecf1fa61f27ea36a0778a5e1510398ed93a1cd6c49532472f6d5be27ec3c93288950fdb

data/.github/ISSUE_TEMPLATE.md

@@ -0,0 +1,8 @@
+## What problems are you experiencing?
+
+
+## Steps to reproduce
+
+
+## What's the output from `ridk version`?
+

data/.gitignore

@@ -0,0 +1,12 @@
+recipes/installer-inno/filelist-*.iss
+recipes/sandbox/ruby-*
+recipes/unpack/ruby-*
+*.7z
+*.dll
+*.exe
+*.gem
+*.tar.bz2
+*.tar.gz
+*.tar.xz
+docs/_site
+docker/gitrepo

data/.yardopts

@@ -0,0 +1,7 @@
+--title "RubyInstaller2"
+--no-private
+lib/ruby_installer/**/*.rb
+lib/ruby_installer.rb
+-
+README.md
+LICENSE.txt

data/CHANGELOG-2.4.md

@@ -0,0 +1,166 @@
+## RubyInstaller-2.4.10-1 - 2020-04-02
+
+### Changed
+- Update to ruby-2.4.10, see [release notes](https://www.ruby-lang.org/en/news/2020/03/31/ruby-2-4-10-released/).
+- Update to OpenSSL-1.0.2u .
+- Replace rb-readline by new reline implementation.
+  It has multiline editing, better support for UTF-8 encoding and many fixes.
+- UTF-8 encoding is now enabled by default in the installer for new installations.
+- IRB history is rewritten to UTF-8 on first start of irb.
+- Don't update MSYS/MINGW packages at `ridk install` per default. #168
+- Show compiler version, used to build ruby in `ridk version`. #171
+
+
+## RubyInstaller-2.4.9-1 - 2019-10-02
+
+### Changed
+- Update to ruby-2.4.9, see [release notes](https://www.ruby-lang.org/en/news/2019/10/02/ruby-2-4-9-released/).
+- Fix code signatures of installer executables. They were invalid at the 2.4.7-1 release.
+- Update to OpenSSL-1.0.2t .
+
+
+## RubyInstaller-2.4.7-1 - 2019-09-09
+
+### Added
+- Add support for scoop installer. #152
+
+### Changed
+- Update to ruby-2.4.7, see [release notes](https://www.ruby-lang.org/en/news/2019/08/28/ruby-2-4-7-released/).
+- Ignore registry entries with invalid installer data when looking for MSYS2. #154
+
+
+## RubyInstaller-2.4.6-1 - 2019-04-13
+
+### Changed
+- Update to ruby-2.4.6, see [release notes](https://www.ruby-lang.org/en/news/2019/04/01/ruby-2-4-6-released/).
+- Build with "-O3" instead of "-O2" optimization and update x64 compiler from gcc-8.2.1 to 8.3.0.
+- New tool `ridk use` to switch between installed ruby versions
+- Update of the SSL CA certificate list.
+
+
+## RubyInstaller-2.4.5-1 - 2018-10-21
+
+### Changed
+- Installer files are signed with a Microsoft trusted certificate now.
+- Strip debug information from compiled extensions.
+  This significantly decreases install size of C based gems. #130
+- Fix RubyInstaller update mechanism, so that it no longer removes the PATH setting. #125
+- Update to OpenSSL-1.0.2p and libgdbm-1.18.
+- Update of the SSL CA certificate list.
+
+
+## RubyInstaller-2.4.4-2 - 2018-06-24
+
+### Changed
+- Update `ridk install` to download msys2 installer version 20180531. #115
+- Fix MSYS2 detection in `ridk install`. This broke download of MSYS2 installer. #114
+- Don't crash when the mingw directory within MSYS2 isn't present.
+- Update of the SSL CA certificate list.
+
+
+## RubyInstaller-2.4.4-1 - 2018-03-29
+
+### Added
+- New installer for Ruby with builtin MSYS2 Devkit toolchain. #42
+
+### Changed
+- Update to ruby-2.4.4, see [release notes](https://www.ruby-lang.org/en/news/2018/03/28/ruby-2-4-4-released/).
+- Update to OpenSSL-1.0.2o .
+- Make installers with/without Devkit compatible, so that both can be mixed like:
+  - Install RubyInstaller-Devkit first and update with smaller RubyInstaller later
+  - Install RubyInstaller first and update by RubyInstaller-Devkit
+
+
+## RubyInstaller-2.4.3-2 - 2018-02-27
+
+### Changed
+- Don't abort but fix pacman conflicts while 'ridk install'. #101
+
+
+## RubyInstaller-2.4.3-1 - 2017-12-20
+
+### Changed
+- Update to ruby-2.4.3, see [release notes](https://www.ruby-lang.org/en/news/2017/12/14/ruby-2-4-3-released/).
+- Ignore invalid character encodings when scaning registry for MSYS2.
+  [#86](https://github.com/oneclick/rubyinstaller2/issues/86)
+- Update of the SSL CA certificate list.
+- Uninstall old RubyInstaller version when doing update.
+  It avoids broken and orphaned links in the startmenu
+  [#78](https://github.com/oneclick/rubyinstaller2/issues/78#issuecomment-330115604).
+  See also [updating RubyInstaller](https://github.com/oneclick/rubyinstaller2/wiki/FAQ#q-what-is-recommended-way-to-update-a-ruby-installation).
+
+### Removed
+- Remove package 'winstorecompat' from default dev tools, to make `ridk install` step 2 optional.
+  [#88](https://github.com/oneclick/rubyinstaller2/issues/88)
+
+
+## RubyInstaller-2.4.2-2 - 2017-09-15
+
+### Changed
+- Fix a regession of ruby-2.4.2 to not link to libgmp.
+  See [ruby-2.4.2 release notes](https://www.ruby-lang.org/en/news/2017/09/14/ruby-2-4-2-released/) .
+
+
+## RubyInstaller-2.4.2-1 - 2017-09-15
+
+### Added
+- Sign published files per PGP signature.
+- Set `LANG` variable in `ridk enable` because some MSYS apps require a valid setting.
+  This also enables message translation of gettext enabled apps.
+- Add stdlib gem "dbm", which was missing in previous RI2 versions. #65
+- Add OS name and version to `ridk version`.
+
+### Changed
+- Upload signed files directly from Appveyor to Github for releases.
+- Update of the SSL CA certificate list.
+- Fix gdbm open error by downgrading to gdbm-1.10. [#4](https://github.com/oneclick/rubyinstaller2-packages/pull/4)
+
+### Removed
+- Remove deprecated `RubyInstaller.add_dll_directory`.
+- Remove superflous build flags for libffi from RbConfig. [#8](https://github.com/oneclick/rubyinstaller2-packages/pull/8)
+
+
+## RubyInstaller-2.4.1-2 - 2017-07-04
+
+### Added
+- Add package called 'rubybundle' with embedded MSYS2 tree as preview.
+- Add daily ruby-2.5 snapshot builds, downloadable from [Appveyor](https://ci.appveyor.com/project/larskanis/rubyinstaller2-hbuor/branch/master).
+- Add possibility to set DLL paths per environment variable RUBY_DLL_PATH. Fixes #51
+- Don't run 'ridk install' when installing with silent option. Fixes #43
+
+### Changed
+- Do full MSYS2 system update instead of inventory update only.
+  Fixes possible library inconsistences on a partially updated system.
+- Spin off compile task to https://github.com/oneclick/rubyinstaller2-packages to speedup packaging.
+- Update of dependent DLLs and build tools to latest MSYS2 versions.
+- Update of the SSL CA certificate list.
+
+
+## RubyInstaller-2.4.1-1 - 2017-05-25
+
+The following notable changes are for the transition from [RubyInstaller1](https://github.com/oneclick/rubyinstaller) to [RubyInstaller2](https://github.com/oneclick/rubyinstaller2)
+
+### Added
+- Provides `ridk` tool for easy MSYS2 installation/usage and system version information.
+- RubyInstaller2 bundles its own SSL/TLS CA list derived from the current Mozilla CA list into `<installpath>/ssl/`. See [SSL-README](https://github.com/larskanis/rubyinstaller2/blob/master/resources/ssl/README-SSL.md).
+- Create a default `.irbrc` file for tab completition and history in irb.
+- Ability to add and use `rubyinstaller-build.gem` for customized Ruby-Applications. Documentation coming soon...
+- Run CI tests on AppVeyor for each `git push` to repository.
+- Build and deploy `rubyinstaller.exe` and `7z` packages per AppVeyor and GitHub releases.
+- Allow MSYS2 to be shipped together with Ruby, when installed side by side or within the ruby directory.
+  Refer to the [FAQ](https://github.com/oneclick/rubyinstaller2/wiki/FAQ#user-content-portable-install).
+- Add an installer option to set `RUBYOPT=-Eutf-8`, which sets `Encoding.default_external` to `UTF-8`.
+
+### Changed
+- Built with MINGW GCC-6.3 from the [MSYS2 repository](https://github.com/Alexpux/MINGW-packages).
+- Updated to Ruby-2.4.1.
+- Updated bundled libraries/DLLs.
+- RubyInstaller2 uses a separate DLL directory to avoid conflicting DLLs in the PATH.
+- RubyInstaller2 uses a DLL loading mechanism which ignores the `PATH` environment variable for DLL lookups, but provides a API for DLL directory-addition.
+- Use pure HTML for `Ruby Core + stdlib` documentation instead of CHM files.
+- Add Ruby to the `PATH` and have `.rb` + `.rbw` file association by default.
+- New versioning scheme: `rubyinstaller-<rubyver>-<pkgrel>-<arch>.exe` with `pkgrel` counting from 1 per `rubyver`.
+
+### Removed
+- No more DevKit, but integrates with MSYS2 libraries and toolchain.
+- Remove `tk` from stdlibs, still available per `gem install tk`. This is a upstream change in ruby-2.4.

data/CHANGELOG-2.5.md

@@ -0,0 +1,87 @@
+## RubyInstaller-2.5.8-1 - 2020-04-02
+
+### Changed
+- Update to ruby-2.5.8, see [release notes](https://www.ruby-lang.org/en/news/2020/03/31/ruby-2-5-8-released/).
+- Update to OpenSSL-1.1.1f .
+- Replace rb-readline by new reline implementation.
+  It has multiline editing, better support for UTF-8 encoding and many fixes.
+- UTF-8 encoding is now enabled by default in the installer for new installations.
+- IRB history is rewritten to UTF-8 on first start of irb.
+- Don't update MSYS/MINGW packages at `ridk install` per default. #168
+- Show compiler version, used to build ruby in `ridk version`. #171
+
+
+## RubyInstaller-2.5.7-1 - 2019-10-02
+
+### Changed
+- Update to ruby-2.5.7, see [release notes](https://www.ruby-lang.org/en/news/2019/10/01/ruby-2-5-7-released/).
+- Fix code signatures of installer executables. They were invalid at the 2.5.6-1 release.
+- Update to OpenSSL-1.1.1d .
+
+
+## RubyInstaller-2.5.6-1 - 2019-09-09
+
+### Added
+- Add support for scoop installer. #152
+
+### Changed
+- Update to ruby-2.5.6, see [release notes](https://www.ruby-lang.org/en/news/2019/08/28/ruby-2-5-6-released/).
+- Ignore registry entries with invalid installer data when looking for MSYS2. #154
+
+
+## RubyInstaller-2.5.5-1 - 2019-04-13
+
+### Changed
+- Update to ruby-2.5.5, see [release notes](https://www.ruby-lang.org/en/news/2019/03/15/ruby-2-5-5-released/).
+- Build with "-O3" instead of "-O2" optimization and update x64 compiler from gcc-8.2.1 to 8.3.0.
+- New tool `ridk use` to switch between installed ruby versions
+- Update of the SSL CA certificate list.
+
+
+## RubyInstaller-2.5.3-1 - 2018-10-21
+
+### Changed
+- Installer files are signed with a Microsoft trusted certificate now.
+- Strip debug information from compiled extensions.
+  This significantly decreases install size of C based gems. #130
+- Fix RubyInstaller update mechanism, so that it no longer removes the PATH setting. #125
+- Update to OpenSSL-1.1.1 and libgdbm-1.18.
+- Update of the SSL CA certificate list.
+
+
+## RubyInstaller-2.5.1-2 - 2018-06-24
+
+### Changed
+- Update `ridk install` to download msys2 installer version 20180531. #115
+- Fix MSYS2 detection in `ridk install`. This broke download of MSYS2 installer. #114
+- Don't crash when the mingw directory within MSYS2 isn't present.
+- Update of the SSL CA certificate list.
+
+
+## RubyInstaller-2.5.1-1 - 2018-03-29
+
+### Added
+- New installer for Ruby with builtin MSYS2 Devkit toolchain. #42
+
+### Changed
+- Update to ruby-2.5.1, see [release notes](https://www.ruby-lang.org/en/news/2018/03/28/ruby-2-5-1-released/).
+- Update to OpenSSL-1.1.0h .
+- Make installers with/without Devkit compatible, so that both can be mixed like:
+  - Install RubyInstaller-Devkit first and update with smaller RubyInstaller later
+  - Install RubyInstaller first and update by RubyInstaller-Devkit
+
+
+## RubyInstaller-2.5.0-2 - 2018-02-27
+
+### Changed
+- Don't abort but fix pacman conflicts while 'ridk install'. #101
+
+
+## RubyInstaller-2.5.0-1 - 2017-12-25
+
+### Added
+- Add ruby-2.5.0, see [release notes](https://www.ruby-lang.org/en/news/2017/12/25/ruby-2-5-0-released/).
+
+### Changed
+- RubyInstaller-2.5 bundles OpenSSL-1.1.0 (instead of 1.0.2 of RubyInstaller-2.4).
+  This has some [implications to the Ruby API to OpenSSL](https://bugs.ruby-lang.org/issues/12324).

data/CHANGELOG-2.6.md

@@ -0,0 +1,62 @@
+## RubyInstaller-2.6.6-1 - 2020-04-02
+
+### Changed
+- Update to ruby-2.6.6, see [release notes](https://www.ruby-lang.org/en/news/2020/03/31/ruby-2-6-6-released/).
+- Update to OpenSSL-1.1.1f .
+- Replace rb-readline by new reline implementation.
+  It has multiline editing, better support for UTF-8 encoding and many fixes.
+- UTF-8 encoding is now enabled by default in the installer for new installations.
+- IRB history is rewritten to UTF-8 on first start of irb.
+- Don't update MSYS/MINGW packages at `ridk install` per default. #168
+- Show compiler version, used to build ruby in `ridk version`. #171
+
+
+## RubyInstaller-2.6.5-1 - 2019-10-02
+
+### Changed
+- Update to ruby-2.6.5, see [release notes](https://www.ruby-lang.org/en/news/2019/10/01/ruby-2-6-5-released/).
+- Fix code signatures of installer executables. They were invalid at the 2.6.4-1 release.
+- Fix automatic generation of irbrc. #158
+- Update to OpenSSL-1.1.1d .
+
+
+## RubyInstaller-2.6.4-1 - 2019-09-09
+
+### Added
+- Add support for scoop installer. #152
+
+### Changed
+- Update to ruby-2.6.4, see [release notes](https://www.ruby-lang.org/en/news/2019/08/28/ruby-2-6-4-released/).
+- Ignore registry entries with invalid installer data when looking for MSYS2. #154
+
+
+## RubyInstaller-2.6.3-1 - 2019-04-18
+
+### Changed
+- Update to ruby-2.6.3, see [release notes](https://www.ruby-lang.org/en/news/2019/04/17/ruby-2-6-3-released/).
+
+
+## RubyInstaller-2.6.2-1 - 2019-04-13
+
+### Changed
+- Update to ruby-2.6.2, see [release notes](https://www.ruby-lang.org/en/news/2019/03/13/ruby-2-6-2-released/).
+- Build with "-O3" instead of "-O2" optimization and update x64 compiler from gcc-8.2.1 to 8.3.0.
+- Update of the SSL CA certificate list.
+
+
+## RubyInstaller-2.6.1-1 - 2019-01-30
+
+### Changed
+- Update to ruby-2.6.1, see [release notes](https://www.ruby-lang.org/en/news/2019/01/30/ruby-2-6-1-released/).
+
+
+## RubyInstaller-2.6.0-1 - 2019-01-03
+
+### Added
+- New tool `ridk use` to switch between installed ruby versions
+- Add ruby-2.6.0, see [release notes](https://www.ruby-lang.org/en/news/2018/12/25/ruby-2-6-0-released/).
+- Add `bundle` command, since bundler is now a bundled gem in ruby-2.6
+
+
+### Changed
+- Update of the SSL CA certificate list.

data/CHANGELOG-2.7.md

@@ -0,0 +1,22 @@
+## RubyInstaller-2.7.1-1 - 2020-04-02
+
+### Changed
+- Update to ruby-2.7.1, see [release notes](https://www.ruby-lang.org/en/news/2020/03/31/ruby-2-7-1-released/).
+- Update to OpenSSL-1.1.1f .
+- Don't update MSYS/MINGW packages at `ridk install` per default. #168
+- Show compiler version, used to build ruby in `ridk version`. #171
+- IRB history is rewritten to UTF-8 on first start of irb.
+
+
+## RubyInstaller-2.7.0-1 - 2020-01-05
+
+This is the first release based on ruby-2.7.0: https://www.ruby-lang.org/en/news/2019/12/25/ruby-2-7-0-released/
+
+### Changes compared to RubyInstaller-2.6.5-1
+- Replace rb-readline by new reline implementation.
+  It has multiline editing, better support for UTF-8 encoding and many fixes.
+- UTF-8 encoding is now enabled by default in the installer.
+  This is done by setting RUBYOPT=-Eutf-8 and affects Encoding.default_encoding which is then "UTF-8" instead of the console encoding.
+  See [core API](https://ruby-doc.org/core-2.7.0/Encoding.html#method-c-default_external) for more details.
+  Using UTF-8 default encoding avoids inconsistencies between reading and writing files and to other operating systems.
+- IRB history is rewritten to UTF-8 if UTF-8 encoding is enabled.

data/Gemfile

@@ -0,0 +1,6 @@
+source 'https://rubygems.org'
+
+# Specify your gem's dependencies in rubyinstaller.gemspec
+gemspec
+
+gem "octokit"

data/LICENSE.txt

@@ -0,0 +1,25 @@
+Copyright (c) 2007-2020, RubyInstaller Team
+All rights reserved.
+
+Redistribution and use in source and binary forms, with or without
+modification, are permitted provided that the following conditions are met:
+
+  * Redistributions of source code must retain the above copyright
+    notice, this list of conditions and the following disclaimer.
+  * Redistributions in binary form must reproduce the above copyright
+    notice, this list of conditions and the following disclaimer in the
+    documentation and/or other materials provided with the distribution.
+  * Neither the name of the RubyInstaller Team nor the names of its
+    contributors may be used to endorse or promote products derived
+    from this software without specific prior written permission.
+
+THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS "AS IS" AND
+ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED
+WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE
+DISCLAIMED. IN NO EVENT SHALL THE RUBYINSTALLER TEAM BE LIABLE FOR ANY
+DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES
+(INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES;
+LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND
+ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT
+(INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF THIS
+SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.

data/README.md

@@ -0,0 +1,114 @@
+[![Build status](https://ci.appveyor.com/api/projects/status/kq2b5dqv9ay132a2/branch/master?svg=true)](https://ci.appveyor.com/project/larskanis/rubyinstaller2-hbuor/branch/master)
+
+# RubyInstaller2
+
+This project provides an Installer for Ruby-2.4 and newer on Windows based on the MSYS2 toolchain.
+It is the successor to the MSYS1 based [RubyInstaller](https://github.com/oneclick/rubyinstaller/) which was used for Ruby-2.3 and older.
+It is licensed under the 3-clause Modified BSD License.
+
+In contrast to the old RubyInstaller it does not provide its own DevKit, but makes use of the rich set of [MINGW libraries](https://github.com/Alexpux/MINGW-packages) from the [MSYS2 project](https://msys2.github.io/).
+It therefore integrates well into MSYS2 after installation on the target system to provide a build-and-runtime environment for installation of gems with C-extensions.
+This and more changes are documented in the [CHANGELOG](https://github.com/oneclick/rubyinstaller2/blob/master/CHANGELOG-2.4.md#rubyinstaller-241-1---2017-05-25).
+
+## Using the Installer on a target system
+
+- Download and install the latest RubyInstaller2: https://github.com/larskanis/rubyinstaller2/releases
+
+The non-Devkit installer file is enough to use pure Ruby gems or fat binary gems for x64-mingw32 or x86-mingw32.
+In order to install C based source gems, it's recommended to use the Devkit installer version.
+It installs a MSYS2/MINGW build environment into the ruby directory that ships common build tools and libraries.
+
+Some gems require additional packages, which can be installed per `pacman`. See below.
+Its also possible to install MSYS2 manually from https://msys2.github.io/ and run `ridk install` afterwards to add non default, but required development tools.
+For unattended install of Ruby and MSYS2 see the [FAQ chocolatey install](https://github.com/oneclick/rubyinstaller2/wiki/FAQ#user-content-choco-install).
+
+### The `ridk` command
+
+`ridk` is a cmd/powershell script which can be used to install MSYS2 components, to issue MSYS commands like `pacman` or to set environment variables for using MSYS2 development tools from the running shell.
+
+See `ridk help` for further options:
+
+```sh
+  Usage:
+      C:/Ruby24-x64/bin/ridk.cmd [option]
+
+  Option:
+      install                   Install MSYS2 and MINGW dev tools
+      exec <command>            Execute a command within MSYS2 context
+      enable                    Set environment variables for MSYS2
+      disable                   Unset environment variables for MSYS2
+      version                   Print RubyInstaller and MSYS2 versions
+      use                       Switch to a different ruby version
+      help | --help | -? | /?   Display this help and exit
+```
+
+`ridk enable` can be used to enable MSYS2 development tools on the running console.
+This makes `sh`, `pacman`, `make` etc. available on the command line.
+See [the Wiki](https://github.com/oneclick/rubyinstaller2/wiki/The-ridk-tool) for further instructions to the `ridk` command.
+
+### Install gems with C-extensions and additional library dependencies
+
+The base MSYS2 setup includes compilers and other build tools, but doesn't include libraries or DLLs that some gems require as their dependencies.
+Fortunately many of the required libraries are available through the MSYS2 repositories.
+They can be installed per `ridk exec pacman -S mingw-w64-x86_64-libraryname` similar to `apt-get` on Linux.
+Exchange the prefix `mingw-w64-x86_64` by `mingw-w64-i686` for the 32-bit RubyInstaller.
+
+For instance these popular gems can be installed like so from the source gem:
+
+- To install `sqlite3` gem:
+  ```sh
+    ridk exec pacman -S mingw-w64-x86_64-sqlite3
+    gem install sqlite3 --platform ruby
+  ```
+- To install `nokogiri` gem:
+  ```sh
+    ridk exec pacman -S mingw-w64-x86_64-libxslt
+    gem install nokogiri --platform ruby -- --use-system-libraries
+  ```
+
+Some gems are properly labeled to install dependent libraries per pacman.
+See [the wiki](https://github.com/oneclick/rubyinstaller2/wiki/For-gem-developers#msys2-library-dependency) how such a label can be added to gems.
+Also refer the [FAQ](https://github.com/larskanis/rubyinstaller2/wiki/FAQ) for additional install recommendations.
+
+
+## Building the Installer
+
+This repository provides the packaging tasks to build RubyInstaller setup executables and 7zip files.
+It doesn't compile any sources, but makes use of the [MSYS2-MINGW repository](https://github.com/Alexpux/MINGW-packages) and the [RubyInstaller2 pacman repository](https://github.com/oneclick/rubyinstaller2-packages) to download binaries and dependent libraries.
+
+### Automatic build on Appveyor
+
+The installer is regularly built on [AppVeyor](https://ci.appveyor.com/project/larskanis/rubyinstaller2-hbuor) for each push to the github repository.
+AppVeyor also executes the installer and runs all tests on it, so that we are notified about breaking changes.
+In addition to this, a daily build of the latest ruby development snapshot is compiled and packaged as RubyInstaller files.
+It can be downloaded from [github releases](https://github.com/oneclick/rubyinstaller2/releases/tag/rubyinstaller-head) or from [AppVeyor](https://ci.appveyor.com/project/larskanis/rubyinstaller2-hbuor) as build artifacts.
+Check the wiki on how to use [ruby-head versions on Appveyor](https://github.com/oneclick/rubyinstaller2/wiki/For-gem-developers#user-content-appveyor) for your CI builds.
+
+
+### Build RubyInstaller2 on your own machine:
+
+- Make sure you have a working RubyInstaller-2.4+ and Git installation
+- Ensure you have MSYS2 installed either by a RubyInstaller-Devkit version or per `ridk install` with default options
+- Install the latest Inno-Setup (unicode) from http://www.jrsoftware.org/isdl.php
+- Run **cmd.exe** and add **iscc.exe** to PATH:
+  ```sh
+    set PATH=%PATH%;"c:\Program Files (x86)\Inno Setup 5"
+  ```
+- Clone RubyInstaller2 and build all RubyInstaller versions for x86 and x64:
+  ```sh
+    git clone https://github.com/larskanis/rubyinstaller2
+    cd rubyinstaller2
+    bundle install
+    bundle exec rake
+  ```
+- If everything works well, you will find the final setup and archive files: 
+  * `packages/rubyinstaller/recipes/installer-inno/rubyinstaller-<VERSION>-<ARCH>.exe`
+  * `packages/rubyinstaller/recipes/archive-7z/rubyinstaller-<VERSION>-<ARCH>.7z`
+- Also try `rake -T` to see the available build targets.
+
+
+## Known Issues
+
+- It's best to avoid installation into a PATH containing spaces. Some gems won't install.
+- Ruby on Windows is still using non UTF-8 default external encoding: Raised [as ruby bug](https://bugs.ruby-lang.org/issues/13488).
+- Also refer to [the issue list](https://github.com/larskanis/rubyinstaller2/issues).