3 files changed, 134 insertions, 0 deletions
diff --git a/debian/exim4-localscan-plugin-config b/debian/exim4-localscan-plugin-config
new file mode 100755
index 0000000..08fd2cc
--- /dev/null
+++ b/debian/exim4-localscan-plugin-config
@@ -0,0 +1,12 @@
+#!/bin/sh
+
+case "$1" in
+    --localscan-apiversion)
+        sed -rn 's/#define LOCAL_SCAN_ABI_VERSION_(MAJOR|MINOR) *([0-9]+).*/\2/p' \
+            /usr/include/exim4/local_scan.h \
+            | (read MAJOR; read MINOR; echo ${MAJOR}.${MINOR})
+        ;;
+    *)
+        echo Usage: $0 --localscan-apiversion
+	;;
+esac
diff --git a/debian/exim4-localscan-plugin-config.1 b/debian/exim4-localscan-plugin-config.1
new file mode 100644
index 0000000..841ac2a
--- /dev/null
+++ b/debian/exim4-localscan-plugin-config.1
@@ -0,0 +1,40 @@
+.\"     Title: EXIM4-LOCALSCAN-PLUGIN-CONFIG
+.\"    Author: 
+.\" Generator: DocBook XSL Stylesheets v1.72.0 <http://docbook.sf.net/>
+.\"      Date: 2007-06-08
+.\"    Manual: 
+.\"    Source: exim4
+.\"
+.TH "EXIM4\-LOCALSCAN\-PLUGIN\-CONFIG" "1" "2007\-06\-08" "exim4" ""
+.\" disable hyphenation
+.nh
+.\" disable justification (adjust text to left margin only)
+.ad l
+.SH "NAME"
+exim4\-localscan\-plugin\-config \- get information necessary to build and package exim4 plugins
+.SH "SYNOPSIS"
+.HP 13
+\fBexim4\-localscan\-plugin\-config\fR \fB\-\-localscan\-abiversion\fR
+.SH "DESCRIPTION"
+.PP
+\fBexim4\-localscan\-plugin\-config\fR
+is a tool that is used to determine various things needed to build plugins (shared libraries) for the Exim MTA. Currently there is one such plugin API \- the
+\fBlocal_scan\fR
+API. In addition to local_scan plugins, this API is also available to shared libraries used with the ${dlfunc ...} expansion item.
+.SH "OPTIONS"
+.PP
+Since
+\fBexim4\-localscan\-plugin\-config\fR
+is
+Debian(TM)\-specific, it currently takes a single mandatory option parameter,
+\fB\-\-localscan\-apiversion\fR, outputting the API/ABI version (\fIver\fR). Packages containing local_scan plugins should depend on exim4\-localscanapi\-\fIver\fR
+.SH "SEE ALSO"
+\fBexim4\fR(8), Chapter 42 of the Exim specification
+.SH "COPYRIGHT"
+Copyright \(co 2007 Magnus Holmgren
+.br
+.PP
+This manual page was written by Magnus Holmgren for the
+Debian(TM)
+system (but may be used by others). Permission is granted to copy, distribute and/or modify this document without any restrictions whatsoever.
+.br
diff --git a/debian/exim4-localscan-plugin-config.1.xml b/debian/exim4-localscan-plugin-config.1.xml
new file mode 100644
index 0000000..c7e9ef1
--- /dev/null
+++ b/debian/exim4-localscan-plugin-config.1.xml
@@ -0,0 +1,82 @@
+<?xml version='1.0' encoding='ISO-8859-1'?>
+<!DOCTYPE refentry PUBLIC "-//OASIS//DTD DocBook XML V4.2//EN"
+"http://www.oasis-open.org/docbook/xml/4.2/docbookx.dtd" [
+
+  <!ENTITY dhfirstname "<firstname>Magnus</firstname>">
+  <!ENTITY dhsurname   "<surname>Holmgren</surname>">
+  <!-- Please adjust the date whenever revising the manpage. -->
+  <!ENTITY dhdate      "<date>2007-06-08</date>">
+  <!ENTITY dhsection   "<manvolnum>1</manvolnum>">
+  <!ENTITY dhemail     "<email>magnus@kibibyte.se</email>">
+  <!ENTITY dhusername  "Magnus Holmgren">
+  <!ENTITY dhucpackage "<refentrytitle>EXIM4-LOCALSCAN-PLUGIN-CONFIG</refentrytitle>">
+  <!ENTITY dhpackage   "exim4-localscan-plugin-config">
+
+  <!ENTITY debian      "<productname>Debian</productname>">
+]>
+
+<refentry>
+  <refentryinfo>
+    <productname>exim4</productname>
+    <address>
+      &dhemail;
+    </address>
+    <copyright>
+      <year>2007</year>
+      <holder>&dhusername;</holder>
+    </copyright>
+    <legalnotice>
+      <para>
+        This manual page was written by &dhusername; for
+        the &debian; system (but may be used by others).  Permission is
+        granted to copy, distribute and/or modify this document without
+        any restrictions whatsoever.
+      </para>
+    </legalnotice>
+    &dhdate;
+  </refentryinfo>
+  <refmeta>
+    &dhucpackage;
+    &dhsection;
+  </refmeta>
+  <refnamediv>
+    <refname>&dhpackage;</refname>
+    <refpurpose>get information necessary to build and package exim4
+     plugins</refpurpose>
+  </refnamediv>
+  <refsynopsisdiv>
+    <cmdsynopsis>
+      <command>&dhpackage;</command>
+      <arg choice="plain"><option>--localscan-abiversion</option></arg>
+    </cmdsynopsis>
+  </refsynopsisdiv>
+  <refsect1>
+    <title>Description</title>
+
+    <para><command>&dhpackage;</command> is a tool that is used to determine
+    various things needed to build plugins (shared libraries) for the 
+    Exim MTA. Currently there is one such plugin API - the 
+    <function>local_scan</function> API. In addition to local_scan plugins,
+    this API is also available to shared libraries used with the 
+    ${dlfunc ...} expansion item.</para>
+  </refsect1>
+  <refsect1>
+    <title>Options</title>
+    <para>Since <command>&dhpackage;</command> is &debian;-specific,
+    it currently takes a single mandatory option parameter,
+    <option>--localscan-apiversion</option>, outputting the API/ABI 
+    version (<replaceable role="variable">ver</replaceable>). 
+    Packages containing local_scan plugins should depend on 
+    exim4-localscanapi-<replaceable role="variable">ver</replaceable></para>
+  </refsect1>
+  <refsect1>
+    <title>See also</title>
+    <simplelist type="inline">
+      <member><citerefentry>
+        <refentrytitle>exim4</refentrytitle>
+        <manvolnum>8</manvolnum>
+      </citerefentry></member>
+      <member>Chapter 42 of the Exim specification</member>
+    </simplelist>
+  </refsect1>
+</refentry>