README.source for ulogd2
========================

This is a pretty standard 3.0 (quilt) format package, using debhelper 13. There
are no gotchas that I am aware of that may affect NMUs or similar.

git-buildpackage is used to maintain the git tree, and debian/gbp.conf is
included to configure it for this package.

Non-maintainer uploads
----------------------

If you want to be extra-helpful when doing an NMU, please follow these few
simple requests so that I can incorporate your changes into the package as
easily as possible. Note that all of this section is optional, so you do not
*have* to do any of this should you not want to.

### Using Salsa

This package is maintained under the pkg-netfilter umbrella. Any member of the
pkg-netfilter project has commit access to the Git repository. If you are not a
member you are encouraged to fork the repository into your own account and
submit a merge request.

### Using plain Git

Clone the git repo in the usual way, make your changes, then use
git-format-patch and git-send-email to email me the changes, in a manner similar
to kernel development:

(assuming you have made changes in a branch different to the 'master' branch)
$ git format-patch --cover-letter -o patch_dir master
(now sanity check the patch(es) in patch_dir/)
$ git send-email --no-chain-reply --suppress-cc=self patch_dir

Note that I don't require you sign off your patches nor run them through
checkpatch.pl like you would for kernel work.

Import new upstream release
---------------------------

Make sure you have the upstream git repo set up as a remote:

git remote add --tags upstream git://git.netfilter.org/ulogd2

Then, to import a new upstream release:

git checkout master
git fetch upstream  # fetch upstream commits, including tags
gbp import-orig --uscan --upstream-vcs-tag=ulogd-2.0.7 --pristine-tar
