Hacking
=======

Code style
----------

I tend to write programs in C using my own style, which is described at:

	https://strahinja.org/tekstovi/softver/kodni-standard/

(page in Serbian). To automate the formatting of code, I use the program
clang-format with the configuration file located at:

	https://git.sr.ht/~strahinja/dotfiles/tree/master/item/.clang-format

This repository should also contain a copy of that file. You can format the 
files before creating patches to send to me by using the command

	$ clang-format -i filename.c	# also applies to *.h

issued from the main directory of the repository.


Creating customizations
-----------------------

It is perhaps the most efficient to create a separate branch with your
modifications in the repository, then:

	$ git branch my_feature		# if the branch doesn't already exist
	$ git checkout my_feature

and after making changes:

	$ git add -A
	$ git commit -sS
	$ git format-patch master --stdout > my_feature.patch

You can then send the file my_feature.patch by email to my public inbox at

	~strahinja/public-inbox (replace_with_at_sign) lists.sr.ht

To update the branch holding your feature when the upstream changes, you can
instead do:

	$ git checkout my_feature
	$ git rebase --rebase-merges master
	$ git format-patch master --stdout > my_feature.patch