announcement

   1 Subject: dgit 1.0, available for all users
   2
   3 I am pleased to announce dgit 1.0, which can be used, as applicable,
   4 by all contributors and downstreams.
   5
   6 dgit allows you to treat the Debian archive as if it were a git
   7 repository, and get a git view of any package.  If you have the
   8 appropriate access rights you can do builds and uploads from git, and
   9 other dgit users will see your git history.
  10
  11 (dgit's git histories are often disjoint from the maintainer's
  12 history; this is because the dgit git tree has exactly the same
  13 content as the archive, which maintainers' histories often don't.)
  14
  15
  16 Obtaining dgit
  17 --------------
  18
  19 dgit 1.0 was just uploaded to unstable.
  20
  21 The source (latest found in sid) can be obtained via
  22   dgit clone dgit
  23
  24 The last dgitish upload of dgit itself can be found here
  25   w3m https://browse.dgit.debian.org/dgit.git/
  26   git clone https://git.dgit.debian.org/dgit
  27 (but note that this would not reflect any NMUs not done with dgit.)
  28
  29
  30 Existing users
  31 --------------
  32
  33 All existing users who are not running dgit 0.30 or later must
  34 upgrade.  dgit << 0.30 will not cope with git histories manipulated by
  35 later dgit, and will crash trying to access now-moved-aside git
  36 repositories on alioth.  New versions of dgit accept old histories
  37 (and fix them up if necessary).
  38
  39
  40 Anonymous read-only access
  41 --------------------------
  42
  43 dgit 1.0 can be used by anyone to get the source for packages in the
  44 Debian archive.  Changes can then be made in git, and binary packages
  45 built using your favourite build tools.  You can share changes made in
  46 git in the normal gitish ways.
  47
  48
  49 Debian maintainers
  50 ------------------
  51
  52 At the moment, the Debian Project lacks a database listing the public
  53 ssh keys of DMs.  The dgit push infrastructure requires the user's ssh
  54 key to be installed.
  55
  56 For now, this will be done manually.  If you are a DM and would like
  57 to use `dgit push', please send a GPG-signed copy of your ssh public
  58 key to dgit-owner@debian.org.
  59
  60
  61 Backports
  62 ---------
  63
  64 The dgit 1.0 binary package which I have just uploaded to sid is
  65 installable (simply with dpkg -i), and useable back to at least
  66 wheezy.
  67
  68 The source builds on wheezy as-is.  I hope that a formal backport will
  69 be forthcoming soon.
  70
  71
  72 Exciting uses of some of the dgit-repos on alioth
  73 -------------------------------------------------
  74
  75 The previous location for the dgit git repositories was on alioth, in
  76 /git/dgit-repos/repos, where they were writeable by the scm_collab-qa
  77 and Debian groups.  It appears that some contributors took advantage
  78 of this (deliberately or perhaps accidentally) to store various
  79 ancillary git branches and tags in the dgit git repos.
  80
  81 These extra branches and tags have not been reproduced in the new dgit
  82 git service.  (I intend for the dgit git service to become a general
  83 purpose git server with access control similar to that of the Debian
  84 archive, but for now it is not possible to manipulate the refs in the
  85 dgit git service other than via dgit push.)
  86
  87 To prevent old dgits from accidentally operating on stale history, I
  88 have moved these old repos on alioth aside, to
  89 /git/dgit-repos/repos.now-on-gideon.
  90
  91 If you were using these as general-purpose git remotes, please copy
  92 (or move) the data elsewhere.
  93
  94
  95 Thanks
  96 ------
  97
  98 I would like to thank DSA and ftpmaster.
  99
 100 ftpmaster have provided the new archive data API service, which
 101 supports the anonymous queries needed for readonly use of dgit.
 102
 103 DSA have provided hosting for both the main dgit git service, and the
 104 mirror used for read access.  The support I have had from the DSA
 105 team, and particularly Peter Palfrader, has been both excellent and
 106 invaluable.  Without their help none of this would have been possible.