From: Ian Jackson <ijackson@chiark.greenend.org.uk>
Date: Wed, 4 Dec 2013 22:48:38 +0000 (+0000)
Subject: ipif: Provide head comment of service.c as a txt docs.
X-Git-Tag: userv/0.6.1~57
X-Git-Url: https://www.chiark.greenend.org.uk/ucgi/~ian/git?p=userv-utils.git;a=commitdiff_plain;h=28b264ac22b5bb4f39920e6be74d3d59b92c9eac

ipif: Provide head comment of service.c as a txt docs.
---

diff --git a/debian/changelog b/debian/changelog
index c8a0561..a1d232a 100644
--- a/debian/changelog
+++ b/debian/changelog
@@ -8,6 +8,7 @@ userv-utils (0.6.0~~iwj1) unstable; urgency=low
   * Update to GPLv3+; update copyright notices everywhere.
   * ipif: Update docs to reflect fact that we are now using tun/tap.
   * ipif: Deprecate udptunnel.
+  * ipif: Provide head comment of service.c as a txt docs.
 
  --
 
diff --git a/ipif/Makefile b/ipif/Makefile
index 78b4972..fe6ec6e 100644
--- a/ipif/Makefile
+++ b/ipif/Makefile
@@ -38,6 +38,7 @@ PROGRAMS$(depr)+=	udptunnel
 PROGRAMS+=		$(PROGRAM_TARGETS)
 
 DIRS+=			$(libuserv) $(etcuserv) $(services)
+DIRS+=			$(docdir)/userv-ipif
 DIRS$(depr)+=		$(bindir) $(varlibvpn) $(shareuserv)
 
 SHAREFILES$(depr)+=	udptunnel-vpn-config.m4 udptunnel-vpn-defaults
@@ -59,6 +60,7 @@ install:	all
 		set -e; for f in $(SHAREFILES); do cp $$f $(shareuserv)/.; done
 
 install-docs:
+		sed -n '1,/^$$/p' service.c >$(docdir)/userv-ipif/service.c.txt
 
 install-examples:
 		set -e; if [ "x$depr" = x ]; then \
diff --git a/ipif/ipif b/ipif/ipif
index f8c5838..c6784c7 100644
--- a/ipif/ipif
+++ b/ipif/ipif
@@ -1,3 +1,5 @@
+# See /usr/share/doc/userv-ipif/service.c.txt
+#
 if ( grep calling-user-shell /etc/shells
    & glob service-user root
    )