@@ -18,18 +18,18 @@ Perl, including those with write access to the git repository.
18
18
=head1 CLONING THE REPOSITORY
19
19
20
20
All of Perl's source code is kept centrally in a Git repository at
21
- I<perl5.git.perl.org >.
21
+ I<github.com >.
22
22
23
23
You can make a read-only clone of the repository by running:
24
24
25
- % git clone git://perl5.git.perl.org/perl .git perl
25
+ % git clone git://github.com/Perl/perl5 .git perl
26
26
27
27
This uses the git protocol (port 9418).
28
28
29
29
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:
31
31
32
- % git clone https://perl5.git.perl.org/perl .git perl
32
+ % git clone https://github.com/Perl/perl5 .git perl
33
33
34
34
=head1 WORKING WITH THE REPOSITORY
35
35
@@ -341,12 +341,12 @@ patch will be destroyed.
341
341
Someone may download your patch from RT, which will result in the
342
342
subject (the first line of the commit message) being omitted. See
343
343
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>
345
345
for an example. Alternatively someone may
346
346
apply your patch from RT after it arrived in their mailbox, by which
347
347
time RT will have modified the inline content of the message. See
348
348
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>
350
350
for a bad example of this failure mode.
351
351
352
352
=head2 A note on derived files
@@ -586,7 +586,7 @@ Once you have write access, you will need to modify the URL for the
586
586
origin remote to enable pushing. Edit F<.git/config> with the
587
587
git-config(1) command:
588
588
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
590
590
591
591
You can also set up your user name and e-mail address. Most people do
592
592
this once globally in their F<~/.gitconfig> by doing something like:
@@ -602,7 +602,7 @@ execute something like the following in F<perl>:
602
602
It is also possible to keep C<origin> as a git remote, and add a new
603
603
remote for ssh access:
604
604
605
- % git remote add camel perl5. git.perl.org:/perl .git
605
+ % git remote add camel git@github.com:Perl/perl5 .git
606
606
607
607
This allows you to update your local repository by pulling from
608
608
C<origin>, which is faster and doesn't require you to authenticate, and
@@ -814,35 +814,6 @@ original commit in the new commit message.
814
814
Before pushing any change to a maint version, make sure you've
815
815
satisfied the steps in L</Committing to blead> above.
816
816
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
-
846
817
=head2 Using a smoke-me branch to test changes
847
818
848
819
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
853
824
OSes: push it to a "smoke-me" branch and wait for certain automated
854
825
smoke-testers to report the results from their OSes.
855
826
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
857
828
component is precisely C<smoke-me>.
858
829
859
830
The procedure for doing this is roughly as follows (using the example of
0 commit comments