From: Ian Jackson <ijackson@chiark.greenend.org.uk>
Date: Sat, 30 Jun 2018 23:57:45 +0000 (+0100)
Subject: WIP
X-Git-Url: http://www.chiark.greenend.org.uk/ucgi/~ianmdlvl/git?a=commitdiff_plain;h=b96356f3e396a025d4e1182b39a7e0aa76bafde8;p=dgit.git

WIP
---

diff --git a/dgit-downstream-dsc.7.pod b/dgit-downstream-dsc.7.pod
index 59ef6c32..fcbce058 100644
--- a/dgit-downstream-dsc.7.pod
+++ b/dgit-downstream-dsc.7.pod
@@ -220,7 +220,7 @@ Set C<git-check> to B<true>.
 
 Otherwise, set C<git-check> to a url prefix - ideally, https.
 dgit clone will try to fetch
-C<git-check>I<package>C<git-check-suffix>
+C<git-check>B</>I<package>C<git-check-suffix>
 and expect to get either some successful fetch (it doesn't matter what)
 or a file not found error (http 404 status code).
 Other outcomes are fatal errors.
@@ -259,13 +259,13 @@ in the 2nd field of each B<sources.list> entry.
 =item B<dgit-distro.>I<distro>B<.archive-query>, B<.archive-query-url>
 
 If you have a smallish distro,
-set this to B<aptget:> (with a colon).
+set C<archive-query> to B<aptget:> (with a colon).
 
 If your distro is large
 (eg, if it contains a substantial fraction of Debian)
 then this will not be very efficient:
 with this setting,
-dgit often needs to downloads and update Sources files.
+dgit often needs to download and update Sources files.
 
 For large distros,
 it is better to implement the Debian archive ftpmaster API.
@@ -276,6 +276,12 @@ dgit uses these queries:
 B<suites>,
 B<dsc_in_suite/>I<isuite>B</>I<package> and
 B<file_in_archive/>I<pat>
+(so you need not implement anything else).
+
+Alternatively,
+if your system supports the rmadison protocol,
+you can set C<archive-query> to B<madison:>[I<madison-distro>].
+dgit will invoke B<rmadison> -uI<madison-distro>.
 
 =item B<dgit-suite.>I<suite>B<.distro> I<distro>
 
@@ -296,6 +302,11 @@ dgit will use the user's shell access to the server to
 B<cp -a _template.git> I<package>B<.git>.
 So you should create B<_template.git> with suitable contents.
 
+Note that the ssh rune invoked by dgit does not do any locking.
+So if two people dgit push the same package at the same time,
+there will be lossage.
+Either don't do that, or set up B<dgit-repos-server>.
+
 =head1 SSH COMMANDS
 
 When a user who can push runs dgit,