Corrections to SYNCING

* Reflow some paragraphs due to repo-naming pushing the line length over 80
  chaacters.

* Correct path to git clone commands for each repo.
This commit is contained in:
Thomas Adam 2013-01-30 23:28:38 +00:00
parent c4c98df4f2
commit 6e6d756109

34
SYNCING
View File

@ -13,7 +13,9 @@ Here's a description of them:
Note: The "tmux-openbsd" repository is actually handled by "git cvsimport" Note: The "tmux-openbsd" repository is actually handled by "git cvsimport"
running at 15 minute intervals, so a commit made to OpenBSD's tmux CVS running at 15 minute intervals, so a commit made to OpenBSD's tmux CVS
repository will take that long to appear in this git repository. repository will take at least that long to appear in this git repository.
(It might take longer, depending on the CVS mirror used to import the
OpenBSD code).
It is assumed that the person doing the sync has read/write access to the It is assumed that the person doing the sync has read/write access to the
tmux-code repository on SourceForge already. tmux-code repository on SourceForge already.
@ -38,8 +40,8 @@ Cloning repositories
This involves having both tmux-code and tmux-openbsd cloned, as in: This involves having both tmux-code and tmux-openbsd cloned, as in:
% cd /some/where/useful % cd /some/where/useful
% git clone ssh://${USER}@tmux.git.sf.net/gitroot/tmux/tmux % git clone ssh://${USER}@git.code.sf.net/p/tmux/tmux
% git clone ssh://${USER}@tmux.git.sf.net/gitroot/tmux/tmux-openbsd % git clone ssh://${USER}@git.code.sf.net/p/tmux/tmux-openbsd
Note that you do not need additional checkouts to manage the sync -- an Note that you do not need additional checkouts to manage the sync -- an
existing clone of either repositories will suffice. So if you already have existing clone of either repositories will suffice. So if you already have
@ -48,13 +50,13 @@ these checkouts existing, skip that.
Adding in git-remotes Adding in git-remotes
===================== =====================
Because the portable "tmux-code" git repository and the "tmux-openbsd" repository do Because the portable "tmux-code" git repository and the "tmux-openbsd"
not inherently share any history between each other, the history has been repository do not inherently share any history between each other, the
faked between them. This "faking of history" is something which has to be history has been faked between them. This "faking of history" is something
told to git for the purposes of comparing the "tmux" and "tmux-openbsd" which has to be told to git for the purposes of comparing the "tmux" and
repositories for syncing. To do this, we must reference the clone of the "tmux-openbsd" repositories for syncing. To do this, we must reference the
"tmux-openbsd" repository from the "tmux-code" repository, as shown by the clone of the "tmux-openbsd" repository from the "tmux-code" repository, as
following command: shown by the following command:
% cd /path/to/tmux-code % cd /path/to/tmux-code
% git remote add obsd-tmux file:///path/to/tmux-openbsd % git remote add obsd-tmux file:///path/to/tmux-openbsd
@ -83,8 +85,8 @@ Then back in "tmux-code":
Creating the necessary branches Creating the necessary branches
=============================== ===============================
Now that "tmux-code" can see commits and branches from "tmux-openbsd" by way of Now that "tmux-code" can see commits and branches from "tmux-openbsd" by way
the remote name "obsd-tmux", we can now create the master branch from of the remote name "obsd-tmux", we can now create the master branch from
"tmux-openbsd" in the "tmux-code" repository: "tmux-openbsd" in the "tmux-code" repository:
% git checkout -b obsd-master obsd-tmux/master % git checkout -b obsd-master obsd-tmux/master
@ -92,10 +94,10 @@ the remote name "obsd-tmux", we can now create the master branch from
Adding in the fake history points Adding in the fake history points
================================= =================================
To tie both the "master" branch from "tmux-code" and the "obsd-master" branch To tie both the "master" branch from "tmux-code" and the "obsd-master"
from "tmux-openbsd" together, the fake history points added to the branch from "tmux-openbsd" together, the fake history points added to the
"tmux-code" repository need to be added. To do this, we must add an additional refspec "tmux-code" repository need to be added. To do this, we must add an
line, as in: additional refspec line, as in:
% cd /path/to/tmux-code % cd /path/to/tmux-code
% git config --add remote.origin.fetch '+refs/replace/*:refs/replace/*' % git config --add remote.origin.fetch '+refs/replace/*:refs/replace/*'