fork the xbmc repo to your own repo. If you havent done this already, just go to
https://github.com/xbmc/xbmc and click fork in the top right. It'll make a "fork" to your own repo (eg
https://github.com/barronen1/xbmc where barronen1 is whatever your github user name is.
I dont use any gui git apps, so if you do, may want to just look at the documentation of the app on how to add a git remote
1. assuming you have already cloned an xbmc repo of some sort. i'll also assume that it is the xbmc org one linked above.
in a terminal, got to the dir (eg ~/xbmc or wherever its cloned to currently)
do a git fetch to get the most up to date version of the xbmc repo
cpp:
git fetch origin
2. type
cpp:
git remote add barronen1 https://github.com/barronen1/xbmc
3. you can check the remotes you have by using
cpp:
git remote -v
You should see something like
cpp:
git remote -v
barronen https://github.com/barronen1/xbmc (fetch)
barronen https://github.com/barronen1/xbmc (push)
origin https://github.com/xbmc/xbmc.git (fetch)
origin https://github.com/xbmc/xbmc.git (push)
4. I assume you will have some changes to the checked out repo already, and i assume this wasnt done in a branch. What i would do is to do
cpp:
git checkout master
git reset --hard origin/master
Should show something like
cpp:
git reset --hard origin/master
HEAD is now at 44eec3c9c0 Merge pull request #22599 from fuzzard/depends_gtest
5. From here, you want to create a new branch. We'll call it fix_androiddocs. do the following command
cpp:
git checkout -b fix_androiddocs
6. Now, you have a branch ready for your changes. Open your preferred editor, and update any relevant files. Presumably you'll want to look at docs/README.Android.md in your ~/xbmc/ folder.
7. Now you are happy with the changes. All ready to commit them.
cpp:
git add --all
git commit -m "[Docs][Android] Fix stage 6 instruction"
The message can be whatever you want. generally keep it short and to the point. That title says its a Doc update, for Android, and then a short description of the change. If you need to explain more, you can do multiple -m commands, and it will merge the message into paragraphs. The first -m is the title, so keep it short.
cpp:
git commit -m "[Docs][Android] Fix stage 6 instruction" -m "Longer explanation of the commit"
[master b43ad6cb26] [Docs][Android] Fix stage 6 instruction
1 file changed, 1 insertion(+), 1 deletion(-)
and the if you do git log, it'll show you
cpp:
git log
commit b43ad6cb268d62ec326e2ad75fc7d4496342d77d (HEAD -> master)
Author: fuzzard <fuzzard@kodi.tv>
Date: Sat Feb 4 11:17:21 2023 +1000
[Docs][Android] Fix stage 6 instruction
Longer explanation of the commit
8. Once thats all done, you are ready to push to your barronen repo.
cpp:
git push barronen
9. From here, open up the xbmc repo in a browser (
https://github.com/xbmc/xbmc/pulls) and generally you will see a message to open a PR. For more details, refer to Githubs docs
https://docs.github.com/en/pull-requests...rom-a-fork
