Skip to content

Commit 8219e79

Browse files
committed
Update POD and comments to reference GitHub as canonical repository
1 parent 6579c3d commit 8219e79

File tree

10 files changed

+27
-58
lines changed

10 files changed

+27
-58
lines changed

Changes

Lines changed: 2 additions & 3 deletions
Original file line numberDiff line numberDiff line change
@@ -8,9 +8,8 @@ For a list of contributors to perl, see AUTHORS.
88

99
If you need a detailed commit history (i.e. descriptions of each
1010
individual commit), you can view the git version control history online
11-
at https://perl5.git.perl.org/perl.git (follow the 'shortlog' link beside
12-
the relevant tag). Or, you can download a copy of the git repository and
13-
then run a command like
11+
at https://github.com/Perl/perl5. Or, you can download a copy of the git
12+
repository and then run a command like
1413

1514
git log --name-status v5.12.0..v5.14.0
1615

Porting/README.pod

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -361,7 +361,7 @@ A helper tool for perl's 2038 support See F<Porting/README.y2038> for details.
361361
=head2 F<todo.pod>
362362

363363
This is a list of wishes for Perl. The most up-to-date version of this file is
364-
at L<https://perl5.git.perl.org/perl.git/blob_plain/HEAD:/Porting/todo.pod>.
364+
at L<https://github.com/Perl/perl5/blob/blead/Porting/todo.pod>.
365365
The tasks we think are smaller or easier are listed first. Anyone is welcome
366366
to work on any of these, but it's a good idea to first contact
367367
I<[email protected]> to avoid duplication of effort, and to learn from

Porting/todo.pod

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -5,7 +5,7 @@ todo - Perl TO-DO list
55
=head1 DESCRIPTION
66

77
This is a list of wishes for Perl. The most up to date version of this file
8-
is at L<https://perl5.git.perl.org/perl.git/blob_plain/HEAD:/Porting/todo.pod>
8+
is at L<https://github.com/Perl/perl5/blob/blead/Porting/todo.pod>.
99

1010
The tasks we think are smaller or easier are listed first. Anyone is welcome
1111
to work on any of these, but it's a good idea to first contact

configpm

Lines changed: 2 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -150,7 +150,7 @@ $config_txt .= sprintf << 'EOT', $], $export_funcs;
150150

151151
# for a description of the variables, please have a look at the
152152
# Glossary file, as written in the Porting folder, or use the url:
153-
# https://perl5.git.perl.org/perl.git/blob/HEAD:/Porting/Glossary
153+
# https://github.com/Perl/perl5/blob/blead/Porting/Glossary
154154

155155
package Config;
156156
use strict;
@@ -896,7 +896,7 @@ named variable exists.
896896

897897
For a description of the variables, please have a look at the
898898
Glossary file, as written in the Porting folder, or use the url:
899-
https://perl5.git.perl.org/perl.git/blob/HEAD:/Porting/Glossary
899+
https://github.com/Perl/perl5/blob/blead/Porting/Glossary
900900

901901
=over 4
902902

cop.h

Lines changed: 2 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -103,8 +103,8 @@ typedef struct jmpenv JMPENV;
103103
*
104104
* The original patches that introduces flexible exceptions were:
105105
*
106-
* https://perl5.git.perl.org/perl.git/commit/312caa8e97f1c7ee342a9895c2f0e749625b4929
107-
* https://perl5.git.perl.org/perl.git/commit/14dd3ad8c9bf82cf09798a22cc89a9862dfd6d1a
106+
* https://github.com/Perl/perl5/commit/312caa8e97f1c7ee342a9895c2f0e749625b4929
107+
* https://github.com/Perl/perl5/commit/14dd3ad8c9bf82cf09798a22cc89a9862dfd6d1a
108108
*
109109
*/
110110

hints/dec_osf.sh

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -263,7 +263,7 @@ toke_cflags='optimize=-O2'
263263
esac
264264

265265
# The patch 23787
266-
# https://perl5.git.perl.org/perl.git/commit/73cb726371990cd489597c4fee405a9815abf4da
266+
# https://github.com/Perl/perl5/commit/73cb726371990cd489597c4fee405a9815abf4da
267267
# broke things for gcc (at least gcc 3.3) so that many of the pack()
268268
# checksum tests for formats L, j, J, especially when combined
269269
# with the < and > specifiers, started to fail if compiled with plain -O3.

pod/perlgit.pod

Lines changed: 9 additions & 38 deletions
Original file line numberDiff line numberDiff line change
@@ -18,18 +18,18 @@ Perl, including those with write access to the git repository.
1818
=head1 CLONING THE REPOSITORY
1919

2020
All of Perl's source code is kept centrally in a Git repository at
21-
I<perl5.git.perl.org>.
21+
I<github.com>.
2222

2323
You can make a read-only clone of the repository by running:
2424

25-
% git clone git://perl5.git.perl.org/perl.git perl
25+
% git clone git://github.com/Perl/perl5.git perl
2626

2727
This uses the git protocol (port 9418).
2828

2929
If you cannot use the git protocol for firewall reasons, you can also
30-
clone via http, though this is much slower:
30+
clone via http:
3131

32-
% git clone https://perl5.git.perl.org/perl.git perl
32+
% git clone https://github.com/Perl/perl5.git perl
3333

3434
=head1 WORKING WITH THE REPOSITORY
3535

@@ -341,12 +341,12 @@ patch will be destroyed.
341341
Someone may download your patch from RT, which will result in the
342342
subject (the first line of the commit message) being omitted. See
343343
L<RT #74192|https://rt.perl.org/Ticket/Display.html?id=74192> and
344-
L<commit a4583001|https://perl5.git.perl.org/perl.git/commitdiff/a4583001>
344+
L<commit a4583001|https://github.com/Perl/perl5/commit/a4583001>
345345
for an example. Alternatively someone may
346346
apply your patch from RT after it arrived in their mailbox, by which
347347
time RT will have modified the inline content of the message. See
348348
L<RT #74532|https://rt.perl.org/Ticket/Display.html?id=74532> and
349-
L<commit f9bcfeac|https://perl5.git.perl.org/perl.git/commitdiff/f9bcfeac>
349+
L<commit f9bcfeac|https://github.com/Perl/perl5/commit/f9bcfeac>
350350
for a bad example of this failure mode.
351351

352352
=head2 A note on derived files
@@ -586,7 +586,7 @@ Once you have write access, you will need to modify the URL for the
586586
origin remote to enable pushing. Edit F<.git/config> with the
587587
git-config(1) command:
588588

589-
% git config remote.origin.url ssh://perl5.git.perl.org/perl.git
589+
% git config remote.origin.url git@github.com:Perl/perl5.git
590590

591591
You can also set up your user name and e-mail address. Most people do
592592
this once globally in their F<~/.gitconfig> by doing something like:
@@ -602,7 +602,7 @@ execute something like the following in F<perl>:
602602
It is also possible to keep C<origin> as a git remote, and add a new
603603
remote for ssh access:
604604

605-
% git remote add camel perl5.git.perl.org:/perl.git
605+
% git remote add camel git@github.com:Perl/perl5.git
606606

607607
This allows you to update your local repository by pulling from
608608
C<origin>, which is faster and doesn't require you to authenticate, and
@@ -814,35 +814,6 @@ original commit in the new commit message.
814814
Before pushing any change to a maint version, make sure you've
815815
satisfied the steps in L</Committing to blead> above.
816816

817-
=head2 Merging from a branch via GitHub
818-
819-
While we don't encourage the submission of patches via GitHub, that
820-
will still happen. Here is a guide to merging patches from a GitHub
821-
repository.
822-
823-
% git remote add avar git://github.com/avar/perl.git
824-
% git fetch avar
825-
826-
Now you can see the differences between the branch and blead:
827-
828-
% git diff avar/orange
829-
830-
And you can see the commits:
831-
832-
% git log avar/orange
833-
834-
If you approve of a specific commit, you can cherry pick it:
835-
836-
% git cherry-pick 0c24b290ae02b2ab3304f51d5e11e85eb3659eae
837-
838-
Or you could just merge the whole branch if you like it all:
839-
840-
% git merge avar/orange
841-
842-
And then push back to the repository:
843-
844-
% git push origin blead
845-
846817
=head2 Using a smoke-me branch to test changes
847818

848819
Sometimes a change affects code paths which you cannot test on the OSes
@@ -853,7 +824,7 @@ Fortunately, there is a way to get your change smoke-tested on various
853824
OSes: push it to a "smoke-me" branch and wait for certain automated
854825
smoke-testers to report the results from their OSes.
855826
A "smoke-me" branch is identified by the branch name: specifically, as
856-
seen on perl5.git.perl.org it must be a local branch whose first name
827+
seen on github.com it must be a local branch whose first name
857828
component is precisely C<smoke-me>.
858829

859830
The procedure for doing this is roughly as follows (using the example of

pod/perlhack.pod

Lines changed: 7 additions & 8 deletions
Original file line numberDiff line numberDiff line change
@@ -27,7 +27,7 @@ for a bug, comment fixes, etc., it's easy! Here's how:
2727
The perl source is in a git repository. You can clone the repository
2828
with the following command:
2929

30-
% git clone git://perl5.git.perl.org/perl.git perl
30+
% git clone https://github.com/Perl/perl5.git perl
3131

3232
=item * Ensure you're following the latest advice
3333

@@ -157,7 +157,7 @@ Perl core.
157157
=head1 GETTING THE PERL SOURCE
158158

159159
All of Perl's source code is kept centrally in a Git repository at
160-
I<perl5.git.perl.org>. The repository contains many Perl revisions
160+
I<github.com>. The repository contains many Perl revisions
161161
from Perl 1 onwards and all the revisions from Perforce, the previous
162162
version control system.
163163

@@ -169,23 +169,22 @@ L<perlgit>.
169169
You will need a copy of Git for your computer. You can fetch a copy of
170170
the repository using the git protocol:
171171

172-
% git clone git://perl5.git.perl.org/perl.git perl
172+
% git clone git://github.com/Perl/perl5.git perl
173173

174174
This clones the repository and makes a local copy in the F<perl>
175175
directory.
176176

177177
If you cannot use the git protocol for firewall reasons, you can also
178-
clone via http, though this is much slower:
178+
clone via http:
179179

180-
% git clone https://perl5.git.perl.org/perl.git perl
180+
% git clone https://github.com/Perl/perl5.git perl
181181

182182
=head2 Read access via the web
183183

184184
You may access the repository over the web. This allows you to browse
185-
the tree, see recent commits, subscribe to RSS feeds for the changes,
185+
the tree, see recent commits, subscribe to repository notifications,
186186
search for particular commits and more. You may access it at
187-
L<https://perl5.git.perl.org/perl.git>. A mirror of the repository is
188-
found at L<https://github.com/Perl/perl5>.
187+
L<https://github.com/Perl/perl5>.
189188

190189
=head2 Read access via rsync
191190

pod/perlsource.pod

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -214,7 +214,7 @@ platform-specific Configure-like scripts, as well as F<Configure>
214214
itself.
215215

216216
The metaconfig system has its own git repository. Please see its README
217-
file in L<https://perl5.git.perl.org/metaconfig.git/> for more details.
217+
file in L<https://github.com/Perl/metaconfig> for more details.
218218

219219
The F<Cross> directory contains various files related to
220220
cross-compiling Perl. See F<Cross/README> for more details.

pod/perltodo.pod

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -5,7 +5,7 @@ perltodo - Link to the Perl to-do list
55
=head1 DESCRIPTION
66

77
The Perl 5 to-do list is maintained in the git repository, and can
8-
be viewed at L<https://perl5.git.perl.org/perl.git/blob/HEAD:/Porting/todo.pod>
8+
be viewed at L<https://github.com/Perl/perl5/blob/blead/Porting/todo.pod>.
99

1010
(The to-do list used to be here in perltodo. That has stopped, as installing a
1111
snapshot that becomes increasingly out of date isn't that useful to anyone.)

0 commit comments

Comments
 (0)