From d70ff74d4cae6ae9d880d33d39fd1edc96c8a385 Mon Sep 17 00:00:00 2001 From: "Will \"Coke\" Coleda" Date: Thu, 22 Oct 2015 12:12:20 -0400 Subject: [PATCH 1/3] use more -correct- unicode ilmari++ --- docs/release_guide.pod | 32 ++++++++++++++++---------------- 1 file changed, 16 insertions(+), 16 deletions(-) diff --git a/docs/release_guide.pod b/docs/release_guide.pod index 709ccd79bab..87acecadf69 100644 --- a/docs/release_guide.pod +++ b/docs/release_guide.pod @@ -2,12 +2,12 @@ =head1 release_guide.pod - guide to Rakudo releases -Rakudo’s development release cycle is the Thursday following the +Rakudoʼs development release cycle is the Thursday following the third Tuesday of each month (This historically allowed Rakudo to -follow Parrot’s release cycle). +follow Parrotʼs release cycle). Each development release is given a sequential number and a code name -based on an active Perl Mongers group. Rakudo’s February 2009 release +based on an active Perl Mongers group. Rakudoʼs February 2009 release was #14; prior releases were bundled as part of monthly Parrot releases. For releases made so far, see the list of development releases at the end of this document. @@ -23,7 +23,7 @@ end of this document. =head2 Suggested .pm group names for future releases Names can be gotten from L if you -can’t think of one with any particular significance to Perl +canʼt think of one with any particular significance to Perl 6 or Rakudo. =head2 Steps to create a release (for release managers) @@ -32,7 +32,7 @@ can’t think of one with any particular significance to Perl =item 1. -A few days before the Rakudo release, it’s a good idea to... +A few days before the Rakudo release, itʼs a good idea to... =over 4 @@ -61,7 +61,7 @@ the release announcement). =item * Create a draft release announcement in docs/announce/YYYY.MM.md in -markdown format. You can often use the previous release’s file as a +markdown format. You can often use the previous releaseʼs file as a starting point, updating the release number, version information, name, etc. as appropriate. @@ -70,17 +70,17 @@ etc. as appropriate. =item * -If it’s a month relatively early in the calendar year, +If itʼs a month relatively early in the calendar year, double-check that the copyright date in the README file includes -the current year. (It’s not necessary to update copyright dates +the current year. (Itʼs not necessary to update copyright dates in other files, unless you know that a given file has been modified -in a year not reflected by the file’s copyright notice.) +in a year not reflected by the fileʼs copyright notice.) =back =item 2. -Update Rakudo’s leap-second tables: +Update Rakudoʼs leap-second tables: $ perl tools/update-tai-utc.pl src/core/tai-utc.pm @@ -89,7 +89,7 @@ commit the new version: $ git commit src/core/tai-utc.pm -But probably there won’t be any new leap seconds, in which case the file +But probably there wonʼt be any new leap seconds, in which case the file will be unchanged. B: this program requires the perl modules L, @@ -107,8 +107,8 @@ This can be conveniently done with =item 4. -When it’s time to cut the release, finalize the new release -announcement in docs/announce/YYYY.MM.md . (If one hasn’t already +When itʼs time to cut the release, finalize the new release +announcement in docs/announce/YYYY.MM.md . (If one hasnʼt already been created, see step 1 above.) Highlight areas in which the new release is significant. If possible, also give some small details about the choice of release name. (If the details @@ -136,7 +136,7 @@ you find any steps that are missing. =item 6. Create an NQP release with the same C version number -as Rakudo. Follow NQP’s C file to do that. +as Rakudo. Follow NQPʼs C file to do that. =item 7. @@ -237,7 +237,7 @@ compiler release announcements ONLY to perl6-compiler@perl.org. once they are known, or we may begin publishing a single announcement for both.) -Don’t send out any announcements until the files are actually available +Donʼt send out any announcements until the files are actually available per step 14 above. =item 17. @@ -246,7 +246,7 @@ Update the Wikipedia entry at L. =item 18. -You’re done! Celebrate with the appropriate amount of fun. +Youʼre done! Celebrate with the appropriate amount of fun. =back From a76c349870bbc9f25fb0465d553139a9b1df9903 Mon Sep 17 00:00:00 2001 From: "Will \"Coke\" Coleda" Date: Thu, 22 Oct 2015 12:31:24 -0400 Subject: [PATCH 2/3] use more -correct- unicode ilmari++ --- docs/announce/2015.10.md | 16 ++++++++-------- 1 file changed, 8 insertions(+), 8 deletions(-) diff --git a/docs/announce/2015.10.md b/docs/announce/2015.10.md index c6749b0fca4..8aad2cd0c88 100644 --- a/docs/announce/2015.10.md +++ b/docs/announce/2015.10.md @@ -1,10 +1,10 @@ # Announce: Rakudo Perl 6 compiler, Development Release #92 (“Placeholder”) -On behalf of the Rakudo development team, I’m very happy to announce the October +On behalf of the Rakudo development team, Iʼm very happy to announce the October 2015 release of Rakudo Perl 6 #92 “Placeholder”. Rakudo is an implementation of Perl 6 on the Moar Virtual Machine[^1] and the Java Virtual Machine. -This is the “Birthday” release of Rakudo Perl 6; It’s the first release +This is the “Birthday” release of Rakudo Perl 6; Itʼs the first release candidate of the compiler for the anticipated 6.0 “Christmas” release. The “Christmas” release will occur on or about 17 December 2015, assuming no critical bugs are found between now and then. Please try @@ -13,12 +13,12 @@ greatly appreciated. The tarball for this release is available from . Please note: This announcement is not for the Rakudo Star -distribution[^2] --- it’s announcing a new release of the compiler +distribution[^2] --- itʼs announcing a new release of the compiler only. For the latest Rakudo Star release, see . The Rakudo Perl compiler follows a monthly release cycle, with each -release named after a Perl Mongers group. This month’s release is named after +release named after a Perl Mongers group. This monthʼs release is named after the Placeholders, who stand in for Perls everywhere. Some of the changes in this release are outlined below: @@ -46,14 +46,14 @@ releases is available in the “docs/release_guide.pod” file. A Rakudo development release typically occurs a few days (often two) after the third Tuesday of each month. -The development team appreciates feedback! If you’re using Rakudo, do +The development team appreciates feedback! If youʼre using Rakudo, do get back to us. Questions, comments, suggestions for improvements, cool discoveries, incredible hacks, or any other feedback -- get in touch with us through (the above-mentioned) mailing list or IRC channel. Enjoy! [^1]: See -[^2]: What’s the difference between the Rakudo compiler and the Rakudo +[^2]: Whatʼs the difference between the Rakudo compiler and the Rakudo Star distribution? The Rakudo compiler is a compiler for the Perl 6 language. @@ -63,6 +63,6 @@ The Rakudo Star distribution is the Rakudo compiler plus a selection of useful Perl 6 modules, a module installer, the most recent incarnation of the “Using Perl 6” book, and other software that can be used with the Rakudo compiler to enhance its utility. Rakudo Star -is meant for early adopters who wish to explore what’s possible with -Rakudo Perl 6 and provide feedback on what works, what doesn’t, and +is meant for early adopters who wish to explore whatʼs possible with +Rakudo Perl 6 and provide feedback on what works, what doesnʼt, and what else they would like to see included in the distribution. From fb39bda0a2c93bc7088f54d9d4699a15273bdeec Mon Sep 17 00:00:00 2001 From: Jonathan Scott Duff Date: Thu, 22 Oct 2015 11:36:03 -0500 Subject: [PATCH 3/3] tool for Coke++ --- docs/release_guide.pod | 4 ++++ tools/available-pm-names.p6 | 8 ++++++++ 2 files changed, 12 insertions(+) create mode 100755 tools/available-pm-names.p6 diff --git a/docs/release_guide.pod b/docs/release_guide.pod index 87acecadf69..3f4268aef69 100644 --- a/docs/release_guide.pod +++ b/docs/release_guide.pod @@ -26,6 +26,10 @@ Names can be gotten from L if you canʼt think of one with any particular significance to Perl 6 or Rakudo. +There is a rudimentary tool for discerning available Perl Monger group +names that have not already been used for a release in +F + =head2 Steps to create a release (for release managers) =over 4 diff --git a/tools/available-pm-names.p6 b/tools/available-pm-names.p6 new file mode 100755 index 00000000000..ff04347dca9 --- /dev/null +++ b/tools/available-pm-names.p6 @@ -0,0 +1,8 @@ +#!/usr/bin/env perl6 + +use LWP::Simple; + +my $json = LWP::Simple.get("http://www.pm.org/groups/perl_mongers.json"); +my @pm-names = from-json($json).map:{ $_ ~~ s/ '.pm' $//; $_ }; +my @release-names = grep { / ^ <[A..Z]> \w+ / }, qx{git tag}.lines; +.say for (@pm-names (-) @release-names).map(*.key).sort;