git-workflows

   1
   2  Main packaging
   3   git branch
   4   contains
   5
   6 -
   7
   8 Delta from upstream
   9  represented as
  10
  11 -
  12
  13 Tools for manipulating
  14  delta from upstream,
  15  building .dsc, etc.
  16
  17
  18 ==================================================
  19
  20  Unmodified
  21   upstream files,
  22  plus debian/*
  23  incl. d/patches
  24
  25 -
  26
  27 debian/patches
  28  (only)
  29
  30 -
  31
  32 quilt / dquilt
  33 Manual patch copying
  34 Manual patch editing
  35 Possibly gbp for building
  36
  37 ==================================================
  38
  39  Modified
  40   upstream files,
  41  plus debian/*.
  42  Maybe d/patches, depending.
  43  History has direct merges from upstream.
  44
  45 -
  46
  47 Direct changes
  48  to upstream files
  49
  50 -
  51
  52 git merge
  53    (.dsc: 1.0-with-diff or
  54    single-debian-patch)
  55
  56 ==================================================
  57
  58  Modified
  59   upstream files,
  60  plus debian/*
  61  Sometimes d/patches.
  62  History is special git-debrebase rebasing topic branch format.
  63
  64 -
  65
  66 Direct changes to
  67  upstream files.
  68
  69 -
  70
  71 git-debrebase
  72
  73 ==================================================
  74
  75  Modified
  76   upstream files,
  77  plus debian/*,
  78  plus d/patches,
  79  plus .git-dpm
  80  History is special git-dpm rebasing topic branch format.
  81
  82 -
  83
  84 Direct changes to
  85  upstream files
  86
  87 -
  88
  89 git-dpm
  90
  91 ==================================================
  92
  93  Only debian/*,
  94  with d/patches
  95
  96 -
  97
  98 d/patches, only;
  99 Baseline upstream:
 100  changelog version =>
 101  upstream git tag
 102
 103 -
 104
 105 gbp ?
 106 quilt/dquilt ?
 107
 108 ==================================================
 109
 110  Only debian/*,
 111  with d/patches
 112
 113 -
 114
 115 d/patches, only;
 116 Baseline upstream:
 117  changelog version =>
 118  .orig tarball(s)
 119
 120 -
 121
 122 gbp ?
 123 quilt/dquilt ?
 124
 125 ==================================================
 126
 127  Template debian/*.
 128  One branch for
 129   many packages.
 130  Tooling to make
 131   d/control etc.
 132   during build
 133
 134 -
 135
 136 Patches in package-
 137  specific subdirectory;
 138
 139 Baseline upstream is
 140  named by reference somehow
 141
 142 -
 143
 144 language-specific
 145  monorepo tooling,
 146  found in same branch
 147
 148
 149 ==================================================
 150
 151 Template debian/*
 152 No upstream files
 153
 154 -
 155
 156 d/patches, only:
 157  changelog version =>
 158  .orig tarball(s)
 159
 160 -
 161
 162 Custom package-specific tooling to generate missing
 163 parts of debian/ from the template(s)
 164
 165 ==================================================
 166
 167 Upstream files from a git tag,
 168 perhaps partially modified
 169
 170 -
 171
 172 Modifications directly in git
 173 plus further patches in d/patches
 174
 175 changelog version => .orig tarball(s)
 176
 177 -
 178
 179 format 1.0-with-diff
 180 debian/rules, not dpkg-source, applies debian/patches
 181
 182 ==================================================
 183
 184 Modified upstream files
 185 plus debian/*
 186 no d/patches
 187
 188 -
 189
 190 Direct changes to upstream files
 191
 192 -
 193
 194 git-debcherry
 195
 196 ==================================================
 197