[welcome] Update the build recipe for JamMin
completed by: Radu T
mentors: Scott McCreary, Urias McCullough, Adrien Destugues - PulkoMandy
JamMin has a working recipe file, but it is using a patch to fix some build problems. However as JamMin is an open Source app that is hosted on HaikuArchives, it does not make sense to keep the patch on HaikuPorts.
- Fork the app on github
- Apply the patch from Haikuports.
- Next submit a pull request with your changes.
- Have it merged. And while you wait...
- Remove the patch from the recipe file and from HaikuPorts, submit changes to HaikuPorts.
- Now submit URLs for both the pull requests here to finish.
Haikuporter is our tool to fetch, patch and build source code and create Haiku packages that can then be put into a repository to be installed by the user via HaikuDepot.
For this task, you have to create a haikuporter recipe, which is a kind of script that automates this process. Depending on the targeted software you may need these skills:
- Some knowledge of C, C++, git and bash
- Knowledge of the GNU autotools and/or cmake
- The package may require some patching to get it to work on Haiku
Before submitting your work, make sure to test your recipe by creating a hpkg package from it with haikuporter. Haiku's Expander app can open hpkg files to inspect their contents.
Take care to include all required licenses and copyright entries.
For this task you need to have
- Haiku installed; get a nightly image and see the Haiku Guides for more information on using Haiku. There's also a Userguide and Welcome page on your Desktop when you boot Haiku.
- Haikuporter installed and the haikuports bitbucket cloned, see the "Getting started" wiki page.
- Studied the haikuporter wiki.
- Submit your work as pull request to haikuports bitbucket (see "DevelopmentModel" in the wiki).
While there is a slight learning curve to writing recipes, other GCI recipe tasks will become easier and easier the more you complete successfully.
In addition to the wiki, studying working recipes in the haikuports tree can be a big help. Besides requesting assistance by leaving a comment in this task, a trip to the main IRC channel #haiku may prove to be quicker (consider possible timezone differences with your mentors).