Differences
This shows you the differences between two versions of the page.
| Both sides previous revisionPrevious revisionNext revision | Previous revision |
| contribute:dev:coding:example [2020/08/30 03:55] – Suggest merge request instead of patch andreldm | contribute:dev:coding:example [2022/03/28 11:12] (current) – [Building from source] alexxcons |
|---|
| First things first, Xfce’s modular architecture feature several components, some are part of its core and some are optional apps or panel plugins. Take some time to read their description. You might wonder what the heck is a window manager? or I never heard of freedesktop.org or d-bus, are they edible?. Search for them, I can’t possibly explain everything there is to know about Linux desktops in a single blog post. | First things first, Xfce’s modular architecture feature several components, some are part of its core and some are optional apps or panel plugins. Take some time to read their description. You might wonder what the heck is a window manager? or I never heard of freedesktop.org or d-bus, are they edible?. Search for them, I can’t possibly explain everything there is to know about Linux desktops in a single blog post. |
| |
| In my opinion the best way to get started with code is to scratch your own itch, you know, deal with that annoying bug or a behavior that could be improved. The rule of thumb is to browse Xfce’s Bugzilla and look for that bug or report it in case no one noticed the problem until now. Then go to Xfce’s repository browser, clone the repository for the component you are about to hack, fix the problem and send a merge request. That’s easy for me to say, isn’t it? I’m going to prove you it is not that hard, let’s go step by step. | In my opinion the best way to get started with code is to scratch your own itch, you know, deal with that annoying bug or a behavior that could be improved. The rule of thumb is to browse Xfce’s GitLab and look for that bug or report it in case no one noticed the problem until now. Then go to Xfce’s repository browser, clone the repository for the component you are about to hack, fix the problem and send a merge request. That’s easy for me to say, isn’t it? I’m going to prove you it is not that hard, let’s go step by step. |
| |
| ===== Building from source ===== | ===== Building from source ===== |
| Suppose we are interested in hacking xfce4-appfinder, the first thing we need to do is to build and be able to run that component: | Suppose we are interested in hacking xfce4-appfinder, the first thing we need to do is to build and be able to run that component: |
| |
| <code>git clone git://git.xfce.org/xfce/xfce4-appfinder | <code>git clone https://gitlab.xfce.org/xfce/xfce4-appfinder |
| cd xfce4-appfinder | cd xfce4-appfinder |
| ./autogen.sh --prefix=/usr --enable-debug | ./autogen.sh --prefix=/usr --enable-debug |
| === Sharing Code === | === Sharing Code === |
| |
| Now you know how to build components and smash bugs, browse [[https://gitlab.xfce.org/|the isssues reported on Gitlab]] and try to fix something that looks easy. If you have an idea on how to fix or some code that seems to work but you are not so sure, don’t be afraid to ask at #xfce-dev. Once you have a good enough solution, follow [[https://docs.xfce.org/contribute/dev/git/start#gitlab_forks_and_merge_requests|these steps]] in order to create a merge request. Wait a few days, if you get no answer, poke us at #xfce-dev or use the Xfce4-dev mailing list. After some merge requests, you may [[https://docs.xfce.org/contribute/dev/get-a-contributor-account|ask commit rights]] and join the dev club, yay! | Now you know how to build components and smash bugs, browse [[https://gitlab.xfce.org/|the isssues reported on Gitlab]] and try to fix something that looks easy. If you have an idea on how to fix some code that seems to work but you are not so sure, don’t be afraid to ask at #xfce-dev. Once you have a good enough solution, follow [[https://docs.xfce.org/contribute/dev/git/start#gitlab_forks_and_merge_requests|these steps]] in order to create a merge request. Wait a few days, if you get no answer, poke us at #xfce-dev or use the Xfce4-dev mailing list. After some merge requests, you may [[https://docs.xfce.org/contribute/dev/get-a-contributor-account|ask commit rights]] and join the dev club, yay! |
| |
| This page is just an extract of AndreLDM's blog. You may want to read the full [[https://andreldm.com/2018/12/03/xfce-contributor-guide.html|Ultimate Contributor's Guide to Xfce]]. | This page is just an extract of AndreLDM's blog. You may want to read the full [[https://andreldm.com/2018/12/03/xfce-contributor-guide.html|Ultimate Contributor's Guide to Xfce]]. |