| title | summary |
|---|---|
Git Basics |
Basic git commands for packaging |
The recommended way to switch branches is git switch.
To create a new branch use git switch -c.
If there any new changes to the repository whilst you are still working on your branch you need to sync your fork.
Run git fetch, and git rebase origin/main to pull the changes in.
You will need to fix any conflicts manually.
You can check your branch against main with git diff origin/main..my-branch.
For every file you change or add, you must let git know about it: git add someFile
For files that need to be removed, you must do so using git: git rm someFile
Likewise, for renaming a file, you must do so via git: git mv someFile someFileName2
It's a good idea to review the changes you have made to each file. This is to make sure you're committing what you intend and to make sure it looks good. Do this before adding changed files.
To diff them all at once, useful for small changes, use git diff.
To diff each file one at a time run git diff filename on each one.
Check your branch
Get the status of the branch with git status. Make sure all the files you changed are staged, and that there are no untracked files. The git status should say your branch is clean.
Now that you've tested and reviewed your change, when you're happy with it, it's time to commit your changes with git commit.
Once your pull request has been accepted you can delete your working branches. First, change to the package directory, switch to the main branch, then delete your local and the remote branches.
cd ~/solus-packages
git switch main
git branch -D my-branch
git push -d origin my-branch