debian/README.source

   1 Git sources for Debian
   2 ----------------------
   3
   4 The git Debian package sources are available through git, and
   5 through 'apt-get source git'.  Getting the sources through git
   6 should be preferred:
   7
   8  # apt-get install git  # if not yet done
   9
  10  $ git clone https://repo.or.cz/r/git/debian.git/ git
  11  $ cd git
  12
  13 After cloning the repository, you have checked out the debian-sid
  14 branch, ready to be used by dpkg-buildpackage, e.g.
  15
  16  $ dpkg-buildpackage -i -rfakeroot -uc -us
  17
  18 If you want to make changes in the ./debian/ subdirectory, this is the
  19 correct branch to work on.  After making changes, document them in
  20 debian/changelog, and commit through 'git add' and 'git commit', or 'git
  21 commit -a', or similar.  If you think the changes should be incorporated
  22 into the standard Debian package, create the patch[es] through 'git
  23 format-patch', and send them to the Debian Bug Tracking System, e.g.
  24
  25  $ vi debian/rules
  26  $ debchange -pi
  27  $ git commit -a
  28  $ git format-patch HEAD^
  29
  30
  31 If you want to make changes to the upstream git sources, first checkout
  32 the release+patches branch
  33
  34  $ git checkout -b release+patches origin/release+patches
  35
  36 The release+patches branch holds patches on top of the current release
  37 version that is packaged for Debian/unstable. The current release
  38 version is available in the release branch.  If you are interested, you
  39 can checkout this branch too
  40
  41  $ git checkout -b release origin/release
  42
  43 When releasing a new Debian package based on a new upstream release, the
  44 release branch will be fastforwarded, and the release+patches branch is
  45 rewound and rebased on the new HEAD of the release branch.  This is done
  46 by
  47
  48  $ git checkout release
  49  $ git merge v1.6.5
  50  $ git checkout release+patches
  51  $ git rebase release
  52
  53 You generally don't need to do that, but beware that the release+patches
  54 branch is rewound occasionally.
  55
  56 After checking out the release+patches branch, make the desired changes
  57 to the upstream sources, and commit them.  To integrate the changes into
  58 the Debian package, extract these changes, and change to the debian-sid
  59 branch (Note: the file extension for the patches is '.diff', use 'git
  60 config --add format.suffix .diff' to make that the default)
  61
  62  $ git format-patch release..release+patches
  63  $ git checkout debian-sid
  64
  65 Now move the extracted patches into the debian/patches/ directory, add
  66 their filenames to debian/patches/series, add a meaningful message to
  67 debian/changelog, and commit the changes to the debian-sid branch:
  68
  69  $ ls ????-*.diff >> debian/patches/series
  70  $ mv ????-*.diff debian/patches/
  71  $ git add debian/patches
  72  $ debchange -pi
  73  $ git add debian/changelog
  74  $ git commit
  75
  76 Again, if you think the changes should be incorporated into the standard
  77 Debian package, create the patch[es] from the debian-sid branch through
  78 'git format-patch', send them to the Debian Bug Tracking System.
  79
  80 There's a mailing list to coordinate work on the git-core packages, if
  81 you're interested in helping please subscribe to the
  82 <debian-package-git> mailing list by sending an email to
  83 <debian-package-git-subscribe@list.smarden.org>.
  84
  85  -- Gerrit Pape <pape@smarden.org>  Sat, 10 Apr 2010 12:28:52 +0000