announcement

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