This repo contains the openSUSE defaults and branding modifications of the Xfce desktop.

If you want to work on modifications for a new release, please create a branch based on the latest version, make your changes there and push it as new branch to github.

Do not rebase the history - the repository becomes too large otherwise and we need to be able to deleted old branches at times.

Working with this repo in Pagure

On github concepts: origin links to your forked repository and we standardized the name of the original to upstream by convention.

First, create a fork of the repo, following this guide: https://docs.pagure.org/pagure/usage/forks.html

Then clone your fork to your PC:

git clone https://code.opensuse.org/forks/$YOUR_PAGURE_ACCOUNT/xfce/xfce4-branding-openSUSE.git

and add the original repository as remote:

cd xfce4-branding-openSUSE
git remote add upstream https://code.opensuse.org/xfce/xfce4-branding-openSUSE.git

Fetch the original content and checkout/merge the branch you want to work on:

git fetch upstream
git checkout -b main
git merge upstream main

Now you can work with your local branch as you normally would.

To commit your changes to your fork, do:

git commit -m "A useful description (eventually boo#NR) describing what changed"

(use -a if all the changes are relatives to the same commit)

git push

This will update your repository fork.

Then you can create a pull request, as described here: https://docs.pagure.org/pagure/usage/pull_requests.html

If you want to sync with upstream changes, do a:

git fetch upstream
git merge upstream main

(this is doing manually what git pull will do when set up)