diff options
Diffstat (limited to 'README.md')
-rw-r--r-- | README.md | 47 |
1 files changed, 33 insertions, 14 deletions
@@ -1,25 +1,44 @@ # Rakudo Star -This git repository contains _only_ the tools needed to create a Rakudo Star distribution. +Rakudo Star is a user-oriented distribution of the Raku programming language, +and a number of common community modules. -The `tar` files available from `github.com` -are NOT suitable for building Rakudo Star; do not use them. +This git repository contains _only_ the tools needed to create a Rakudo Star +distribution, not the sources of individual components of the distribution. +These are fetched when you build the distribution tarball. + +The `tar` files available from `github.com` for MoarVM, NQP and Rakudo are NOT +suitable for building Rakudo Star; do not use them. Instead, use the tarballs +found on the individual projects' sites, which correctly contain all the +utilities and dependencies used by them. ## Get Rakudo Star -To get the latest release of Rakudo Star, please download the corresponding file depending on your platform. -* [Linux](https://rakudo.org/latest/star/source) -* [Windows](https://rakudo.org/latest/star/win64) -* [macOS](https://rakudo.org/latest/star/macos) +To get the latest release of Rakudo Star, please download the corresponding +file depending on your platform. + +- [Linux](https://rakudo.org/latest/star/source) +- [Windows](https://rakudo.org/latest/star/win64) +- [macOS](https://rakudo.org/latest/star/macos) ## Build Rakudo Star -If you're a Rakudo Star release manager, or someone who wants to create a new Perl 6 -distribution based on the tools here, then run `make -f tools/star/Makefile` to -populate a distribution image. -## Guides -* [Release guide](tools/star/release-guide.pod) +If you're a Rakudo Star release manager, or someone who wants to create a +user-friendly Raku distribution based on the tools here, check the `guides` +directory. This contains documentation on how to make a Rakudo Star tarball, as +well as information on how to create Windows `.msi` and MacOS `.dmg` packages. + +### Quickstart + + export VERSION=quickstart # Update to whatever version number you want to use + ./bin/mkrelease.sh "$VERSION" + mkdir -p work/build + tar xzf "work/release/rakudo-star-$VERSION.tar.gz" -C work/build + cd "work/build/rakudo-star-$VERSION" + perl Configure.pl --prefix="../../install" --backend=moar --gen-moar --make-install -* [Guide to build MSI packages](tools/star/windows-msi.pod) +If you're satisfied, you probably want to generate checksums and a detached PGP +signature for the release. -* [Guide to build DMG packages](tools/star/mac-dmg.pod) + ./bin/mkchecksum "work/release/rakudo-star-$VERSION.tar.gz" + gpg --armor --detach-sign "work/release/rakudo-star-$VERSION.tar.gz" |