From e80cda47a357007d87afa8b27c28e81ff26cd35a Mon Sep 17 00:00:00 2001
From: Ian Jackson <ijackson@chiark.greenend.org.uk>
Date: Sun, 24 Jun 2018 23:31:25 +0100
Subject: [PATCH] WIP

---
 dgit-downstream-dsc.7.pod | 98 +++++++++++++++++++++++++++++++--------
 1 file changed, 78 insertions(+), 20 deletions(-)

diff --git a/dgit-downstream-dsc.7.pod b/dgit-downstream-dsc.7.pod
index 49822194..7219503f 100644
--- a/dgit-downstream-dsc.7.pod
+++ b/dgit-downstream-dsc.7.pod
@@ -134,28 +134,86 @@ you are ready to explain to dgit how to access your systems.
 
 dgit is configured via git's configuration system,
 so this is done with git configuration.
+See L<git-config(1)>.
 
+=over
+
+=item git url structure
+
+The format of the readonly unauthenticated urls
+(hopefully https, but http or git will do)
+for your packages' git repos.
+These will be of the form:
+C<git-url>I<package-name>C<git-url-suffix>.
+
+Configure:
+
+B<dgit-distro.>I<you>B<.git-url> = C<git-url>
+
+B<dgit-distro.>I<you>B<.git-url-suffix> = C<git-url-suffix> (if any)
+
+=item git server access via ssh
+
+dgit push will either
+B<ssh> I<localusername>B<@>C<push.git-host>
+or
+B<ssh> C<push.git-user-force>B<@>C<push.git-host>
+
+Configure:
+
+B<dgit-distro.>I<you>B</push.git-url> ""
+
+B<dgit-distro.>I<you>B</push.git-host> C<push.git-host>
+
+dgit-distro.I<you>/push.git-user-force C<push.git-user-force>
+(eg you would set this too B<git> if your hosting service
+expects every user to ssh to git@service)
+
+C<dgit-distro.>I<you>B</push.git-proto> B<git+ssh://>
+
+C<dgit-distro.>I<you>B</push.git-path> "/dgit/I<you>/repos"
+
+=item git repository existence testing
+
+
+
+
+
+=back
+
+ for your git server,
+
+
+its name for sshing into it,
+and the path on the server 
+
+Assuming your git server package
+
+
+
+dgit-distro.I<you>.git-url-suffix .git
+
+
+dgit-distro.I<you>.git-check "true"
+
+dgit-distro.I<you>.git-check-suffix "/info/refs"
+
+dgit-distro.I<you>/push.git-check "ssh-cmd"
+
+dgit-distro.I<you>/push.git-create "true"
+
+dgit-distro.I<you>.upload-host I<you>
+
+dgit-distro.I<you>.mirror http://archive.I<you>.org/I<you>
+
+dgit-distro.I<you>.archive-query "aptget:"
+
+dgit-suite.wheezy-staging.distro I<you>
+
+dgit-suite.jessie-staging.distro I<you>
+
+dgit-suite.stretch-staging.distro I<you>
 
-git config dgit-distro.raspbian.git-url https://dgit.raspbian.org/
-git config dgit-distro.raspbian.git-url-suffix .git
-git config dgit-distro.raspbian/push.git-url ""
-git config dgit-distro.raspbian/push.git-host dgit.raspbian.org
-git config dgit-distro.raspbian/push.git-user-force dgit
-git config dgit-distro.raspbian/push.git-proto "git+ssh://"
-git config dgit-distro.raspbian/push.git-path "/dgit/raspbian/repos"
-git config dgit-distro.raspbian.git-check "true"
-git config dgit-distro.raspbian.git-check-suffix "/info/refs"
-git config dgit-distro.raspbian/push.git-check "ssh-cmd"
-git config dgit-distro.raspbian/push.git-create "true"
-git config dgit-distro.raspbian.upload-host raspbian
-git config dgit-distro.raspbian.mirror http://archive.raspbian.org/raspbian
-git config dgit-distro.raspbian.archive-query "aptget:"
-git config dgit-suite.wheezy-staging.distro raspbian
-git config dgit-suite.jessie-staging.distro raspbian
-git config dgit-suite.stretch-staging.distro raspbian
-
-Please see the reprepro document for that.
-We 
 
 
 If you do not want or need to
-- 
2.30.2