Debian Codegraph @

debian/

README.source (full)
Building from source
--------------------
Install “git-buildpackage” and “devscripts” then run the following:

  debcheckout --git-track '*' util-linux
  cd util-linux
  git branch -l | grep debian
  git checkout debian/unstable
  gbp buildpackage

We recommend you use sbuild to make sure you build in a clean environment:

  gbp buildpackage --git-builder=sbuild -s --no-clean-source

Patch handling
--------------
The official form of modifications to the upstream source are quilt patches in
debian/patches/, like most Debian packages do. You are welcome to use quilt to
add or modify patches, but you might prefer using a git commit based approach.
gbp pq provides that by synthesizing a "patch-queue/<branch>" local branch
which represents each quilt patch as git commit. You create this with

  gbp pq import --force

Then you are in the patch-queue branch and can git log, commit, cherry-pick
upstream commits, rebase, etc. there. After you are done, run

  gbp pq export

which will put you back into the debian branch and update debian/patches/
(including series). You need to git add etc. new patches, add a changelog
and other packaging changes, and then debcommit as usual.

Rebasing patches to a new upstream version
------------------------------------------
gbp pq's "rebase" command does not work very conveniently as it fails on merge
conflicts. First, ensure you are in the debian branch:

  git checkout debian/unstable  # in case you aren't already on it

Fetch new git history from upstream:

  git remote add kzak git://git.kernel.org/pub/scm/utils/util-linux/util-linux.git
  git fetch --tags kzak [upstream-version-tag]

Now, to import a new upstream release into the existing branch,
ie. when updating from v2.24 to v2.24.2,
do:

  gbp pq import --force
  gbp pq switch   # switch back to debian branch from patch-queue branch
  gbp import-orig --upstream-vcs-tag=v2.24.2 ../tarballs/util-linux-2.24.2.tar.xz
  gbp pq switch   # switch to patch-queue branch
  git rebase debian/unstable

  gbp pq export

Note that our debian/gbp.conf disables patch numbers.

Also, don't forget to commit your newly generated patches!

  git add debian/patches
  git commit -v

Cherry-picking upstream patches
-------------------------------
You can add the util-linux upstream branch as an additional remote to the Debian
packaging branch. Call it "kzak" or similar to avoid confusing it
with the already existing "upstream" branch from gbp buildpackage:

  git remote add kzak git://git.kernel.org/pub/scm/utils/util-linux/util-linux.git
  git fetch kzak -n

Now you can look at the upstream log and cherry-pick patches into the
patch-queue branch:

  gbp pq import --force
  git log kzak/master
  git cherry-pick 123DEADBEEF

Finally, export and commit your newly generated debian/patches changes:
  gbp pq export
  git add debian/patches
  git commit -v

Modifying packaging files
-------------------------------

When making changes to debian/ general "git-buildpackage conventions" apply.
Follow usual git conventions for commit message but also see "man gbp-dch"
META TAGS section.
Finally once you're done update debian/changelog using "gbp dch --auto"
and commit it.


dir..
dir logcheck/
dir pam-configs/
dir patches/
dir po/
dir source/
dir tests/
dir upstream/
file NEWS
file README.build-profiles
file README.source
file bsdextrautils.install
file bsdextrautils.links
file bsdutils.install
file bsdutils.lintian-overrides
file changelog
file clean
file control
file copyright
file debputy.manifest
file eject-udeb.install
file eject-udeb.postinst
file eject-udeb.templates
file eject.install
file fdisk-udeb.install
file fdisk-udeb.lintian-overrides
file fdisk.install
file gbp.conf
file lastlog2.install
file libblkid-dev.install
file libblkid-dev.lintian-overrides
file libblkid1-udeb.install
file libblkid1-udeb.lintian-overrides
file libblkid1.install
file libblkid1.lintian-overrides
file libblkid1.shlibs
file libblkid1.symbols
file libfdisk-dev.install
file libfdisk1-udeb.install
file libfdisk1-udeb.lintian-overrides
file libfdisk1.install
file libfdisk1.lintian-overrides
file libfdisk1.shlibs
file libfdisk1.symbols
file liblastlog2-2.install
file liblastlog2-dev.install
file liblastlog2-dev.lintian-overrides
file libmount-dev.install
file libmount1-udeb.install
file libmount1-udeb.lintian-overrides
file libmount1.install
file libmount1.lintian-overrides
file libmount1.shlibs
file libmount1.symbols
file libpam-lastlog2.dirs
file libpam-lastlog2.install
file libpam-lastlog2.postinst
file libpam-lastlog2.prerm
file libsmartcols-dev.install
file libsmartcols1-udeb.install
file libsmartcols1-udeb.lintian-overrides
file libsmartcols1.install
file libsmartcols1.lintian-overrides
file libsmartcols1.shlibs
file libsmartcols1.symbols
file libuuid1-udeb.install
file libuuid1.install
file libuuid1.shlibs
file libuuid1.symbols
file login.install
file login.lintian-overrides
file login.maintscript
file login.pam
file login.remote.pam
file mount.docs
file mount.examples
file mount.fstab
file mount.install
file mount.lintian-overrides
file not-installed
file rfkill.install
file rules
file salsa-ci.yml
file shlibs.local
file util-linux-extra.install
file util-linux-extra.links
file util-linux-extra.lintian-overrides
file util-linux-extra.preinst
file util-linux-locales.install
file util-linux-locales.lintian-overrides
file util-linux-udeb.install
file util-linux.README.Debian
file util-linux.docs
file util-linux.examples
file util-linux.install
file util-linux.links
file util-linux.lintian-overrides
file util-linux.maintscript
file util-linux.mime
file util-linux.postinst
file util-linux.postrm
file util-linux.prerm
file util-linux.runuser-l.pam
file util-linux.runuser.pam
file util-linux.su-l.pam
file util-linux.su.pam
file uuid-dev.install
file uuid-dev.lintian-overrides
file uuid-runtime.conffiles
file uuid-runtime.install
file watch