summaryrefslogtreecommitdiff
path: root/pod/perlrepository.pod
diff options
context:
space:
mode:
authorNicholas Clark <nick@ccl4.org>2008-12-26 09:13:51 +0000
committerNicholas Clark <nick@ccl4.org>2008-12-26 09:13:51 +0000
commite9c9f4ae5f2d0d58e16bec3b528c1d6eec0c2716 (patch)
tree32df7738b36c34c41acc5a1bf3a4da376db45638 /pod/perlrepository.pod
parent4e32d3ada00dc86f30145cd90e757baad18afd5f (diff)
parentb16c2e4a254d31480561f2bca5aeaeb75328de9c (diff)
downloadperl-e9c9f4ae5f2d0d58e16bec3b528c1d6eec0c2716.tar.gz
Merge branch 'blead' of nicholas@perl5.git.perl.org:/gitroot/perl into blead
Diffstat (limited to 'pod/perlrepository.pod')
-rw-r--r--pod/perlrepository.pod28
1 files changed, 20 insertions, 8 deletions
diff --git a/pod/perlrepository.pod b/pod/perlrepository.pod
index 4c2a7c9926..f075213ade 100644
--- a/pod/perlrepository.pod
+++ b/pod/perlrepository.pod
@@ -32,7 +32,7 @@ the repository using the Git protocol (which uses port 9418):
git clone git://perl5.git.perl.org/perl.git perl-git
-This clones the repository and makes a local copy in the 'perl-git'
+This clones the repository and makes a local copy in the F<perl-git>
directory.
If your local network does not allow you to use port 9418, then you can
@@ -40,7 +40,7 @@ fetch a copy of the repository over HTTP (this is slower):
git clone http://perl5.git.perl.org/perl.git perl-http
-This clones the repository and makes a local copy in the 'perl-http'
+This clones the repository and makes a local copy in the F<perl-http>
directory.
=head2 WRITE ACCESS TO THE REPOSITORY
@@ -79,7 +79,7 @@ remote for ssh access:
% git remote add camel user@camel:/gitroot/perl.git
This allows you to update your local repository by pulling from
-C<origin>, which is faster and doesn't require you to authentify, and
+C<origin>, which is faster and doesn't require you to authenticate, and
to push your changes back with the C<camel> remote:
% git fetch camel
@@ -93,14 +93,13 @@ themselves should have been fetched when pulling from C<origin>.
Once you have changed into the repository directory, you can inspect
it.
-
After a clone the repository will contain a single local branch, which
will be the current branch as well, as indicated by the asterix.
% git branch
* blead
-Using the -a switch to branch will also show the remote tracking
+Using the -a switch to C<branch> will also show the remote tracking
branches in the repository:
% git branch -a
@@ -257,7 +256,7 @@ to Orange Brocard, we should change his name in the AUTHORS file:
You can see what files are changed:
% git status
- # On branch blead
+ # On branch orange
# Changes to be committed:
# (use "git reset HEAD <file>..." to unstage)
#
@@ -385,6 +384,11 @@ However, be aware this will delete ALL untracked content. You can use
to remove all ignored untracked files, such as build and test
byproduct, but leave any manually created files alone.
+If you only want to cancel some uncommitted edits, you can use
+C<git checkout> and give it a list of files to be reverted.
+
+If you want to cancel one or several commits, you can use C<git reset>.
+
=head1 BISECTING
C<git> provides a built-in way to determine, with a binary search in
@@ -456,7 +460,15 @@ tracking branch:
% git checkout --track -b maint-5.005 origin/maint-5.005
-This creates a local branch named maint-5.005, which tracks the remote
-branch origin/maint-5.005. Then you can pull, commit, merge and push as
+This creates a local branch named C<maint-5.005>, which tracks the remote
+branch C<origin/maint-5.005>. Then you can pull, commit, merge and push as
before.
+You can also cherry-pick commits from blead and another branch, by
+using the C<git cherry-pick> command. It is recommended to use the B<-x>
+option to C<git cherry-pick> in order to record the SHA1 of the original
+commit in the new commit message.
+
+=head1 SEE ALSO
+
+The git documentation, accessible via C<git help command>.