Differences
This shows you the differences between two versions of the page.
Both sides previous revisionPrevious revisionNext revision | Previous revision | ||
contribute:dev:git:userrepos [2014/03/05 10:30] – nick | contribute:dev:git:userrepos [2020/04/19 01:27] (current) – ochosi | ||
---|---|---|---|
Line 1: | Line 1: | ||
- | ===== User repositories ===== | ||
- | Contributors now have the possibility | + | ====== Xfce user repositories ====== |
+ | |||
+ | <note important> | ||
+ | |||
+ | Contributors now have the ability | ||
users/ | users/ | ||
- | This is useful when you have no permission to commit upstream directly or you want to work on some code privately without bothering other. Compared to upstream repositories, | + | This is useful when you do not have permission to commit upstream directly or you want to work on some code privately without bothering other developers. Compared to upstream repositories, |
* You can create any branch name and delete them | * You can create any branch name and delete them | ||
- | * Possible | + | * It is possible |
* You can decide which other users have write access to your repository as well, see below | * You can decide which other users have write access to your repository as well, see below | ||
- | * No notification emails are send to the xfce4-commits mailing list | + | * No notification emails are sent to the xfce4-commits mailing list |
- | So also for developers with up-stream access rights, it is always advised to work on large patches in a user repository first. | + | As with developers with up-stream access rights, it is always advised to work on large patches in a user repository first. |
- | ==== Push to a private repository ==== | + | < |
- | Most often you will continue from the upstream repository and then push your changes on top of that to your user repo branch. If so follow the steps below: | + | ===== Push to a private repository ===== |
- | | + | Most often you will continue from the upstream repository and then push your changes on top of that to your user repo branch. If so, follow the steps below: |
- | git clone git:// | + | |
- | + | <file bash> | |
- | # add a new remote repository with the name ' | + | # clone the upstream repository |
- | git remote add private ssh:// | + | git clone git:// |
- | + | ||
- | # create a new branch | + | # add a new remote repository with the name ' |
- | # note we give the local branch name a different name so you can see to which remote it points | + | git remote add private ssh:// |
- | git checkout -b private-bug-1234 | + | |
+ | # create a new branch | ||
+ | # note we give the local branch name a different name so you can see to which remote it points | ||
+ | git checkout -b private-bug-1234 | ||
+ | |||
+ | # improve the code and make commits | ||
| | ||
- | # improve the code and make commits | + | # push you changes |
- | + | # the first time you do this, the server will create the repository if needed | |
- | | + | git push -u private private-bug-1234 |
- | # the first time you do this, the server will create the repository if needed | + | </ |
- | git push | + | |
- | ==== Repository maintenance ==== | + | Then, wait for a few minutes for the git repo to be available on https:// |
- | There are a couple of commands for gitolite to maintain your private repository. | + | ===== Repository maintenance ===== |
- | === Adding | + | There are a couple of commands for [[https:// |
- | Set the '' | ||
- | ssh git@git.xfce.org desc users/ | ||
- | === Give other users write access | + | ==== Fast forward ==== |
- | By default | + | Note that you can't use non fast-forward |
- | ssh git@git.xfce.org perms users/$user/$name + WRITERS $otheruser | + | <file bash> |
+ | git push user :branch ; git push user branch | ||
+ | </file> | ||
+ | ==== Give other users write access ==== | ||
- | The same command as above but with the minus-sign | + | By default, you are the only user with write access to the repository. To allow others to push changes as well (they can only push forward commits, and have no rights to create and delete), use the following command: |
+ | |||
+ | <file bash>ssh git@git.xfce.org perms users/ | ||
+ | |||
+ | To revoke permissions, | ||
+ | <file bash>ssh git@git.xfce.org perms users/ | ||
For more options, like listing permissions, | For more options, like listing permissions, | ||
- | | + | <file bash>ssh git@git.xfce.org perms -h</ |
+ | |||
+ | ==== Deleting your user repositories ==== | ||
+ | |||
+ | If you finished work in your user repository and it has been merged into the mainline, you can delete it from the server. Only the creator of the repo can delete it. Deleting is not done by removing all of the branches through '' | ||
+ | |||
+ | |||
+ | <file bash>ssh git@git.xfce.org D -h</ | ||
+ | |||
+ | For example, you can delete the xfwm4 repository we created earlier as follows: | ||
+ | |||
+ | <file bash># unlock the repository to allow deletion | ||
+ | ssh git@git.xfce.org D unlock users/ | ||
+ | |||
+ | # remove the repository from the server | ||
+ | ssh git@git.xfce.org D rm users/ | ||
+ | </ |