When hacking at ZBar, PLEASE send patches against the latest Git tree!
There are currently 3 mirrors with ZBar:
LinuxTV: Cgit GUI interface: https://git.linuxtv.org/zbar.git/ Git tree: git://linuxtv.org/zbar.git https://git.linuxtv.org/cgit.cgi/zbar.git http://git.linuxtv.org/cgit.cgi/zbar.git
Github: https://github.com/mchehab/zbar.git
Gitlab: https://github.com/mchehab/zbar
You can use git clone to get the latest version from any of the above repositories.
If you haven't already, grab the ZBar git repository. For example, to get it from Github, use:
git clone https://github.com/mchehab/zbar.git
cd zbar
autoreconf -vfi
This will generate ./configure and all that other foo you usually get with a release. You will need to have recent versions of some basic "developer tools" installed in order for this to work, particularly GNU autotools. These versions of autotools are known to work (newer versions should also be fine):
GNU autoconf 2.61
GNU automake 1.10.1
GNU libtool 2.2.6
GNU gettext 0.18.1.1
GNU pkg-config 0.25
xmlto 0.0.20-5 (for docs building)
All above mentioned tools (except xmlto) must be installed in the same prefix. Mixing prefixes (e.g. /usr/bin and /usr/local/bin) may lead to errors in configuration stages.
Please add a good description to your patch adding why it is needed, what the patch does and how. This helps us when reviewing your work when you submit upstream.
We use a process similar to the Linux Kernel for patch submissions. In particular, submitted patches should have a developer's certificate of origin, as described at: https://linuxtv.org/wiki/index.php/Development:_Submitting_Patches#Developer.27s_Certificate_of_Origin_1.1
In practice, please add:
Signed-off-by: your name <your@email>
on your patches.
When you're done hacking, please submit your work back upstream.
If you use Github or Gitlab, you can fork ZBar from it, develop your patches and then push again to your clone, asking the patch merge using the GUI.
Although we prefer if you submit patches via either Github or Gitlab, you can also submit them via e-mail to:
linux-media@vger.kernel.org
If you opt to do so, please place [PATCH ZBar] at the subject of your e-mails for us to not mix them with patches for the Kernel or for other media tools.
To make your patch, run:
git diff > hacked.patch
Other things for you to read, in order to know more about how to submit your work for upstreaming processes in general, that could be useful for you to prepare yourself on submitting patches to ZBar: