[Pkg-gnupg-commit] [gnupg2] 01/01: document package dependencies as a graph

[Daniel Kahn Gillmor]

This is an automated email from the git hooks/post-receive script.

dkg pushed a commit to branch master
in repository gnupg2.

commit 258a56da0df20c4926806652fafdab702a36b96f
Author: Daniel Kahn Gillmor <dkg at fifthhorseman.net>
Date:   Mon Sep 11 12:54:59 2017 -0400

    document package dependencies as a graph
---
 debian/package-dependencies.dot            | 73 ++++++++++++++++++++++++++++++
 debian/rules                               |  4 ++
 debian/simplified-package-dependencies.dot | 43 ++++++++++++++++++
 3 files changed, 120 insertions(+)

diff --git a/debian/package-dependencies.dot b/debian/package-dependencies.dot
new file mode 100644
index 0000000..8297f78
--- /dev/null
+++ b/debian/package-dependencies.dot
@@ -0,0 +1,73 @@
+#!/usr/bin/dot
+
+# interrelationships between binary packages produced by gnupg2 source
+# package:
+
+# it would be good to graph the external dependencies as well.
+
+digraph gnupg2 {
+        # odd-duck packages:
+        node [shape=box];
+        gpgv_udeb [label="gpgv-udeb"];
+        gpgv_static [label="gpgv-static"];
+        gpgv_win32 [label="gpgv-win32"];
+
+        # meta-packages, transitional packages:
+        node [shape=diamond];
+        gnupg_agent [label="gnupg-agent"];
+        gnupg;
+        gnupg2;
+        gpgv2;
+        
+
+        node [shape=ellipse];
+        gpg_agent [label="gpg-agent"];
+        gpg_wks_server [label="gpg-wks-server"];
+        gpg_wks_client [label="gpg-wks-client"];
+        gnupg_l10n [label="gnupg-l10n"];
+        gnupg_utils [label="gnupg-utils"];
+        
+        
+        # depends:
+        edge [color=black];
+        gnupg_agent -> gpg_agent;
+        gpg_agent -> gpgconf;
+        gpg_wks_server -> gpg;
+        gpg_wks_server -> gpg_agent;
+        gpg_wks_client -> gpg;
+        gpg_wks_client -> gpg_agent;
+        gpg_wks_client -> dirmngr;
+        scdaemon -> gpg_agent;
+        gpgsm -> gpgconf;
+        gpg -> gpgconf;
+        gnupg -> dirmngr;
+        gnupg -> gnupg_l10n;
+        gnupg -> gnupg_utils;
+        gnupg -> gpg;
+        gnupg -> gpg_agent;
+        gnupg -> gpg_wks_client;
+        gnupg -> gpg_wks_server;
+        gnupg -> gpgsm;
+        gnupg -> gpgv;
+        gnupg2 -> gnupg;
+        gpgv2 -> gpgv;
+        dirmngr -> gpgconf;
+        
+
+        # recommends:
+        edge [color=red];
+        gpg_agent -> gnupg;
+        gpg_wks_server -> gnupg;
+        gpg_wks_client -> gnupg;
+        gpgsm -> gnupg;
+        gpg -> gnupg;
+        dirmngr -> gnupg;
+        gnupg_utils -> gpg;
+        gnupg_utils -> gpg_agent;
+        gnupg_utils -> gpgconf;
+        gnupg_utils -> gpgsm;
+        
+        # suggests:
+        edge [color=blue];
+        gpgv -> gnupg;
+}
diff --git a/debian/rules b/debian/rules
index e157ce7..223d195 100755
--- a/debian/rules
+++ b/debian/rules
@@ -75,3 +75,7 @@ override_dh_shlibdeps:
 # Make ldap a recommends rather than a hard dependency.
 	dpkg-shlibdeps -Tdebian/dirmngr.substvars -dRecommends debian/dirmngr/usr/lib/gnupg/dirmngr_ldap -dDepends debian/dirmngr/usr/bin/dirmngr*
 	dh_shlibdeps -Ndirmngr
+
+# visualizations of package dependencies:
+debian/%.png: debian/%.dot
+	dot -T png -o $@ $<
diff --git a/debian/simplified-package-dependencies.dot b/debian/simplified-package-dependencies.dot
new file mode 100644
index 0000000..2edb3fb
--- /dev/null
+++ b/debian/simplified-package-dependencies.dot
@@ -0,0 +1,43 @@
+#!/usr/bin/dot
+
+# interrelationships between binary packages produced by gnupg2 source
+# package, if we were to move to the simplified package structure:
+
+# it would be good to graph the external dependencies as well.
+
+digraph gnupg2 {
+        # odd-duck packages:
+        node [shape=box];
+        gpgv_udeb [label="gpgv-udeb"];
+        gpgv_static [label="gpgv-static"];
+        gpgv_win32 [label="gpgv-win32"];
+
+        # meta-packages, transitional packages:
+        node [shape=diamond];
+        gnupg_agent [label="gnupg-agent"];
+        gnupg2;
+        gpgv2;
+        gpgsm;
+        dirmngr;
+        
+        node [shape=ellipse];
+        gnupg_l10n [label="gnupg-l10n"];
+        
+        # depends:
+        edge [color=black];
+        scdaemon -> gnupg;
+        gnupg2 -> gnupg;
+        gnupg_agent -> gnupg;
+        gpgsm -> gnupg;
+        dirmngr -> gnupg;
+        gpgv2 -> gpgv;
+
+        # recommends:
+        edge [color=red];
+        gnupg -> gnupg_l10n;
+        gnupg -> gpgv;
+        
+        # suggests:
+        edge [color=blue];
+        gpgv -> gnupg;
+}

-- 
Alioth's /usr/local/bin/git-commit-notice on /srv/git.debian.org/git/pkg-gnupg/gnupg2.git