chiark / gitweb /
77e7eb44e8c7b145658a27e7b811dbd1305990c1
[dgit-junk.git] / 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.  Earlier versions of dgit will not cope with git histories
35 manipulated by dgit 0.30, and will crash trying to access
36 now-moved-aside git repositories on alioth.  New versions of dgit are
37 happy to accept old histories (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 and useable back to at least wheezy.  I hope that a formal
66 backport will be forthcoming soon.
67
68
69 Exciting uses of some of the dgit-repos on alioth
70 -------------------------------------------------
71
72 The previous location for the dgit git repositories was on alioth, in
73 /git/dgit-repos/repos, where they were writeable by the scm_collab-qa
74 and Debian groups.  It appears that some contributors took advantage
75 of this (deliberately or perhaps accidentally) to store various
76 ancillary git branches and tags in the dgit git repos.
77
78 These extra branches and tags have not been reproduced in the new dgit
79 git service.  (I intend for the dgit git service to become a general
80 purpose git server with access control similar to that of the Debian
81 archive, but for now it is not possible to manipulate the refs in the
82 dgit git service other than via dgit push.)
83
84 To prevent old dgits from accidentally operating on stale history, I
85 have moved these old repos on alioth aside, to
86 /git/dgit-repos/repos.now-on-gideon.
87
88 If you were using these as general-purpose git remotes, please copy
89 (or move) the data elsewhere.
90
91
92 Thanks
93 ------
94
95 I would like to thank DSA and ftpmaster.
96
97 ftpmaster have provided the new ftpmaster data API service, which
98 supports anonymous queries needed for anonymous use of dgit.
99
100 DSA have provided hosting for both the main dgit git service, and a
101 (browseable) mirror used for read access.  The DSA team, and
102 particularly Peter Palfrader, have provided me with excellent support.
103 Without their help none of this would have been possible.
104