add apkg-powered upstream packaging for deb, rpm

Files in a single new distro/ dir allow apkg to build BIRD packages for
various distros directly from upstream sources as well as from upstream
archives.

Please see distro/README.md for more detail as well as apkg docs:

https://apkg.rtfd.io

I've used these files to build bird-2.0.8 on all currently supported
releases of following distros:

* Debian
* Ubuntu
* Fedora
* CentOS
* openSUSE

Please note that latest apkg with accumulated fixes for bird is needed:
https://gitlab.nic.cz/packaging/apkg/-/merge_requests/35

22 files changed, 2150 insertions, 0 deletions

diff --git a/distro/pkg/deb/bird.xml b/distro/pkg/deb/bird.xml
new file mode 100644
index 00000000..4ba3868f
--- /dev/null
+++ b/distro/pkg/deb/bird.xml
@@ -0,0 +1,286 @@
+<?xml version='1.0' encoding='UTF-8'?>
+<!DOCTYPE refentry PUBLIC "-//OASIS//DTD DocBook XML V4.5//EN"
+"http://www.oasis-open.org/docbook/xml/4.5/docbookx.dtd" [
+
+<!--
+
+`xsltproc -''-nonet \
+          -''-param man.charmap.use.subset "0" \
+          -''-param make.year.ranges "1" \
+          -''-param make.single.year.ranges "1" \
+          /usr/share/xml/docbook/stylesheet/nwalsh/manpages/docbook.xsl \
+          manpage.xml'
+
+A manual page <package>.<section> will be generated. You may view the
+manual page with: nroff -man <package>.<section> | less'. A typical entry
+in a Makefile or Makefile.am is:
+
+DB2MAN = /usr/share/sgml/docbook/stylesheet/xsl/nwalsh/manpages/docbook.xsl
+XP     = xsltproc -''-nonet -''-param man.charmap.use.subset "0"
+
+manpage.1: manpage.xml
+        $(XP) $(DB2MAN) $<
+
+The xsltproc binary is found in the xsltproc package. The XSL files are in
+docbook-xsl. A description of the parameters you can use can be found in the
+docbook-xsl-doc-* packages. Please remember that if you create the nroff
+version in one of the debian/rules file targets (such as build), you will need
+to include xsltproc and docbook-xsl in your Build-Depends control field.
+Alternatively use the xmlto command/package. That will also automatically
+pull in xsltproc and docbook-xsl.
+
+Notes for using docbook2x: docbook2x-man does not automatically create the
+AUTHOR(S) and COPYRIGHT sections. In this case, please add them manually as
+<refsect1> ... </refsect1>.
+
+To disable the automatic creation of the AUTHOR(S) and COPYRIGHT sections
+read /usr/share/doc/docbook-xsl/doc/manpages/authors.html. This file can be
+found in the docbook-xsl-doc-html package.
+
+Validation can be done using: `xmllint -''-noout -''-valid manpage.xml`
+
+General documentation about man-pages and man-page-formatting:
+man(1), man(7), http://www.tldp.org/HOWTO/Man-Page/
+
+-->
+
+  <!ENTITY dhfirstname "Giovanni">
+  <!ENTITY dhsurname   "Mascellani">
+  <!ENTITY dhusername  "&dhfirstname; &dhsurname;">
+  <!ENTITY dhemail     "mascellani@poisson.phc.unipi.it">
+  <!ENTITY dhsection   "8">
+  <!ENTITY dhtitle     "BIRD User Manual">
+]>
+
+<refentry>
+  <refentryinfo>
+    <title>&dhtitle;</title>
+    <productname>bird</productname>
+    <authorgroup>
+      <author>
+       <firstname>&dhfirstname;</firstname>
+        <surname>&dhsurname;</surname>
+        <contrib>Wrote this manpage for the Debian system.</contrib>
+        <address>
+          <email>&dhemail;</email>
+        </address>
+      </author>
+    </authorgroup>
+    <copyright>
+      <year>2010</year>
+      <holder>&dhusername;</holder>
+    </copyright>
+    <legalnotice>
+      <para>This manual page was written for the Debian system
+        (and may be used by others).</para>
+      <para>Permission is granted to copy, distribute and/or modify this
+        document under the terms of the GNU General Public License,
+        Version 2 or (at your option) any later version published by
+        the Free Software Foundation.</para>
+      <para>On Debian systems, the complete text of the GNU General Public
+        License can be found in
+        <filename>/usr/share/common-licenses/GPL</filename>.</para>
+    </legalnotice>
+
+  </refentryinfo>
+  <refmeta>
+    <refentrytitle>bird</refentrytitle>
+    <manvolnum>&dhsection;</manvolnum>
+  </refmeta>
+  <refnamediv>
+    <refname>bird</refname>
+    <refpurpose>BIRD Internet Routing Daemon</refpurpose>
+  </refnamediv>
+  <refnamediv>
+    <refname>birdc</refname>
+    <refpurpose>BIRD Internet Routing Daemon remote control</refpurpose>
+  </refnamediv>
+
+  <refsynopsisdiv>
+    <cmdsynopsis>
+      <command>bird</command>
+      <arg choice="opt"><option>-c <replaceable>config-file</replaceable></option></arg>
+      <arg choice="opt"><option>-d</option></arg>
+      <arg choice="opt"><option>-D <replaceable>debug-file</replaceable></option></arg>
+      <arg choice="opt"><option>-f</option></arg>
+      <arg choice="opt"><option>-g <replaceable>group</replaceable></option></arg>
+      <arg choice="opt"><option>-l</option></arg>
+      <arg choice="opt"><option>-p</option></arg>
+      <arg choice="opt"><option>-P <replaceable>pid-file</replaceable></option></arg>
+      <arg choice="opt"><option>-R</option></arg>
+      <arg choice="opt"><option>-s <replaceable>control-socket</replaceable></option></arg>
+      <arg choice="opt"><option>-u <replaceable>user</replaceable></option></arg>
+    </cmdsynopsis>
+    <cmdsynopsis>
+      <command>birdc</command>
+      <arg choice="opt"><option>-l</option></arg>
+      <arg choice="opt"><option>-r</option></arg>
+      <arg choice="opt"><option>-s <replaceable>control-socket</replaceable></option></arg>
+      <arg choice="opt"><option>-v</option></arg>
+    </cmdsynopsis>
+  </refsynopsisdiv>
+
+  <refsect1 id="description">
+    <title>DESCRIPTION</title>
+    <para><command>bird</command> is an Internet Routing Daemon. That is,
+      it sends and receives messages using different protocols in order to
+      discover and exchange routing information with other routing daemons
+      present on the same network. It is able to talk the most widely
+      known routing protocols (such as BGPv4, RIPv2, OSPFv2 and OSPFv3),
+      both on IPv4 and IPv6 and it features a very powerful language for
+      route filtering.</para>
+    <para><command>birdc</command> is a remote control for <command>bird</command>.
+      While <command>bird</command> is running, the system administrator can
+      connect to it using <command>birdc</command>, to inspect its internal
+      status and reconfigure it. The two processes use a Unix socket to
+      communicate. Once started, <command>bird</command> will give access
+      to an interactive shell: commands can be completed with TAB and help
+      can be requested by pressing the key `?'. More documentation on
+      the available commands can be foung on the website, see below.</para>
+  </refsect1>
+
+  <refsect1 id="options">
+    <title>OPTIONS</title>
+    <para>The <command>bird</command> accepts these options:</para>
+    <variablelist>
+      <varlistentry>
+        <term><option>-c <replaceable>config-file</replaceable></option></term>
+        <listitem>
+          <para>Use given configuration file instead of the default /etc/bird/bird.conf.</para>
+        </listitem>
+      </varlistentry>
+      <varlistentry>
+        <term><option>-d</option></term>
+        <listitem>
+          <para>Enable debug messages to stderr, and run bird in foreground.</para>
+        </listitem>
+      </varlistentry>
+      <varlistentry>
+        <term><option>-D <replaceable>debug-file</replaceable></option></term>
+        <listitem>
+          <para>Enable debug messages to given file.</para>
+        </listitem>
+      </varlistentry>
+      <varlistentry>
+        <term><option>-f</option></term>
+        <listitem>
+          <para>Run bird in foreground.</para>
+        </listitem>
+      </varlistentry>
+      <varlistentry>
+        <term><option>-g <replaceable>group</replaceable></option></term>
+        <listitem>
+          <para>Run bird with given group ID.</para>
+        </listitem>
+      </varlistentry>
+      <varlistentry>
+        <term><option>--help</option></term>
+        <listitem>
+          <para>Display command-line options to bird.</para>
+        </listitem>
+      </varlistentry>
+      <varlistentry>
+        <term><option>-l</option></term>
+        <listitem>
+          <para>Look for a configuration file and a communication socket in the
+            current working directory instead of in default system locations.
+            However, paths specified by options <option>-c</option>,
+            <option>-s</option> have higher priority.</para>
+        </listitem>
+      </varlistentry>
+      <varlistentry>
+        <term><option>-p</option></term>
+        <listitem>
+          <para>Just parse the config file and exit. Return value is zero if the
+            config file is valid, nonzero if there are some errors.</para>
+        </listitem>
+      </varlistentry>
+      <varlistentry>
+        <term><option>-P <replaceable>pid-file</replaceable></option></term>
+        <listitem>
+          <para>Create a PID file with given filename.</para>
+        </listitem>
+      </varlistentry>
+      <varlistentry>
+        <term><option>-R</option></term>
+        <listitem>
+          <para>Apply graceful restart recovery after start.</para>
+        </listitem>
+      </varlistentry>
+      <varlistentry>
+        <term><option>-s <replaceable>control-socket</replaceable></option></term>
+        <listitem>
+          <para>Use given filename for a socket for communications with the
+            client (remote control), default is /run/bird/bird.ctl.</para>
+        </listitem>
+      </varlistentry>
+      <varlistentry>
+        <term><option>-u <replaceable>user</replaceable></option></term>
+        <listitem>
+          <para>Drop privileges and run as given user instead of root. The bird
+            would keep CAP_NET_ADMIN and other network-related capabilities
+            necessary for its function.</para>
+        </listitem>
+      </varlistentry>
+      <varlistentry>
+        <term><option>--version</option></term>
+        <listitem>
+          <para>Display bird version.</para>
+        </listitem>
+      </varlistentry>
+    </variablelist>
+
+    <para>The <command>birdc</command> accepts these options:</para>
+    <variablelist>
+      <varlistentry>
+        <term><option>-l</option></term>
+        <listitem>
+          <para>Look for a communication socket in the current working directory.</para>
+        </listitem>
+      </varlistentry>
+      <varlistentry>
+        <term><option>-r</option></term>
+        <listitem>
+          <para>Run <command>birdc</command> in restricted mode: only the
+            `show ...' commands are allowed.</para>
+        </listitem>
+      </varlistentry>
+      <varlistentry>
+        <term><option>-s <replaceable>control-socket</replaceable></option></term>
+        <listitem>
+          <para>Use given filename for a socket for communications with the
+            server, default is /run/bird/bird.ctl.</para>
+        </listitem>
+      </varlistentry>
+      <varlistentry>
+        <term><option>-v</option></term>
+        <listitem>
+          <para>Numeric return codes are dumped along with messages, making
+            them easily parsable by a program. See the programmer's documentation
+            for information about their meanings.</para>
+        </listitem>
+      </varlistentry>
+    </variablelist>
+  </refsect1>
+
+  <refsect1 id="files">
+    <title>FILES</title>
+    <variablelist>
+      <varlistentry>
+        <term><filename>/etc/bird/bird.conf</filename></term>
+        <listitem>
+          <para>The system-wide configuration file to control the
+            behaviour of <application>bird</application>. See
+            the website for more documentation.</para>
+        </listitem>
+      </varlistentry>
+    </variablelist>
+  </refsect1>
+
+  <refsect1 id="see_also">
+    <title>SEE ALSO</title>
+    <para>More documentation con be found on the website:
+      https://bird.network.cz/.</para>
+  </refsect1>
+</refentry>
+
diff --git a/distro/pkg/deb/bird2-doc.docs b/distro/pkg/deb/bird2-doc.docs
new file mode 100644
index 00000000..4c0c6465
--- /dev/null
+++ b/distro/pkg/deb/bird2-doc.docs
@@ -0,0 +1,4 @@
+obj/doc/bird*.html
+obj/doc/bird.pdf
+obj/doc/prog*.html
+obj/doc/prog.pdf
diff --git a/distro/pkg/deb/bird2.bird.init b/distro/pkg/deb/bird2.bird.init
new file mode 100644
index 00000000..ac15e698
--- /dev/null
+++ b/distro/pkg/deb/bird2.bird.init
@@ -0,0 +1,136 @@
+#! /bin/sh
+### BEGIN INIT INFO
+# Provides:          bird
+# Required-Start:    $remote_fs $syslog
+# Required-Stop:     $remote_fs $syslog
+# Default-Start:     2 3 4 5
+# Default-Stop:      0 1 6
+### END INIT INFO
+
+# Author: Ondřej Surý <ondrej@sury.org>
+#
+
+# PATH should only include /usr/* if it runs after the mountnfs.sh script
+PATH=/sbin:/usr/sbin:/bin:/usr/bin
+DESC="BIRD Internet Routing Daemon"
+NAME=bird
+DAEMON=/usr/sbin/$NAME
+BIRD_ARGS=""
+SCRIPTNAME=/etc/init.d/$NAME
+
+# Exit if the package is not installed
+[ -x "$DAEMON" ] || exit 0
+
+# read the RUN variables
+. /etc/bird/envvars
+
+# Define LSB log_* functions.
+# Depend on lsb-base (>= 3.0-6) to ensure that this file is present.
+. /lib/lsb/init-functions
+
+# Create /run/bird with correct permissions
+/usr/lib/bird/prepare-environment
+
+#
+# Function that starts the daemon/service
+#
+do_start()
+{
+	# Return
+	#   0 if daemon has been started
+	#   1 if daemon was already running
+	#   2 if daemon could not be started
+	start-stop-daemon --start --quiet --name $NAME --exec $DAEMON --test > /dev/null \
+		|| return 1
+	start-stop-daemon --start --quiet --name $NAME --exec $DAEMON -- \
+		-u $BIRD_RUN_USER -g $BIRD_RUN_GROUP $BIRD_ARGS \
+		|| return 2
+	# Add code here, if necessary, that waits for the process to be ready
+	# to handle requests from services started subsequently which depend
+	# on this one.  As a last resort, sleep for some time.
+}
+
+#
+# Function that stops the daemon/service
+#
+do_stop()
+{
+	# Return
+	#   0 if daemon has been stopped
+	#   1 if daemon was already stopped
+	#   2 if daemon could not be stopped
+	#   other if a failure occurred
+	start-stop-daemon --stop --quiet --retry=TERM/30/KILL/5 --name $NAME --exec $DAEMON
+	RETVAL="$?"
+	[ "$RETVAL" = 2 ] && return 2
+	# Wait for children to finish too if this is a daemon that forks
+	# and if the daemon is only ever run from this initscript.
+	start-stop-daemon --stop --quiet --oknodo --retry=0/30/KILL/5 --name $NAME --exec $DAEMON
+	[ "$?" = 2 ] && return 2
+	return "$RETVAL"
+}
+
+#
+# Function that sends a SIGHUP to the daemon/service
+#
+do_reload() {
+	#
+	# If the daemon can reload its configuration without
+	# restarting (for example, when it is sent a SIGHUP),
+	# then implement that here.
+	#
+	start-stop-daemon --stop --signal 1 --quiet --name $NAME --exec $DAEMON
+	return 0
+}
+
+case "$1" in
+  start)
+	log_daemon_msg "Starting $DESC" "$NAME"
+	do_start
+	case "$?" in
+		0|1) log_end_msg 0 ;;
+		2) log_end_msg 1 ;;
+	esac
+	;;
+  stop)
+	log_daemon_msg "Stopping $DESC" "$NAME"
+	do_stop
+	case "$?" in
+		0|1) log_end_msg 0 ;;
+		2) log_end_msg 1 ;;
+	esac
+	;;
+  reload|force-reload)
+	#
+	# If do_reload() is not implemented then leave this commented out
+	# and leave 'force-reload' as an alias for 'restart'.
+	#
+	log_daemon_msg "Reloading $DESC" "$NAME"
+	do_reload
+	log_end_msg $?
+	;;
+  restart)
+	log_daemon_msg "Restarting $DESC" "$NAME"
+	do_stop
+	case "$?" in
+	  0|1)
+		do_start
+		case "$?" in
+			0) log_end_msg 0 ;;
+			1) log_end_msg 1 ;; # Old process is still running
+			*) log_end_msg 1 ;; # Failed to start
+		esac
+		;;
+	  *)
+	  	# Failed to stop
+		log_end_msg 1
+		;;
+	esac
+	;;
+  *)
+	echo "Usage: $SCRIPTNAME {start|stop|restart|reload|force-reload}" >&2
+	exit 3
+	;;
+esac
+
+:
diff --git a/distro/pkg/deb/bird2.bird.service b/distro/pkg/deb/bird2.bird.service
new file mode 100644
index 00000000..37e75fb4
--- /dev/null
+++ b/distro/pkg/deb/bird2.bird.service
@@ -0,0 +1,14 @@
+[Unit]
+Description=BIRD Internet Routing Daemon
+After=network.target
+
+[Service]
+EnvironmentFile=/etc/bird/envvars
+ExecStartPre=/usr/lib/bird/prepare-environment
+ExecStartPre=/usr/sbin/bird -p
+ExecReload=/usr/sbin/birdc configure
+ExecStart=/usr/sbin/bird -f -u $BIRD_RUN_USER -g $BIRD_RUN_GROUP $BIRD_ARGS
+Restart=on-abort
+
+[Install]
+WantedBy=multi-user.target
diff --git a/distro/pkg/deb/bird2.docs b/distro/pkg/deb/bird2.docs
new file mode 100644
index 00000000..50bd824b
--- /dev/null
+++ b/distro/pkg/deb/bird2.docs
@@ -0,0 +1,2 @@
+NEWS
+README
diff --git a/distro/pkg/deb/bird2.install b/distro/pkg/deb/bird2.install
new file mode 100644
index 00000000..d0fad47d
--- /dev/null
+++ b/distro/pkg/deb/bird2.install
@@ -0,0 +1,6 @@
+etc/bird/bird.conf /usr/share/bird2/
+debian/envvars /etc/bird/
+debian/prepare-environment /usr/lib/bird/
+usr/sbin/bird
+usr/sbin/birdc
+usr/sbin/birdcl
diff --git a/distro/pkg/deb/bird2.lintian-overrides b/distro/pkg/deb/bird2.lintian-overrides
new file mode 100644
index 00000000..e64c0ef6
--- /dev/null
+++ b/distro/pkg/deb/bird2.lintian-overrides
@@ -0,0 +1 @@
+bird2: binary-without-manpage usr/sbin/birdcl
diff --git a/distro/pkg/deb/bird2.manpages b/distro/pkg/deb/bird2.manpages
new file mode 100644
index 00000000..94898ea1
--- /dev/null
+++ b/distro/pkg/deb/bird2.manpages
@@ -0,0 +1,2 @@
+bird.8
+birdc.8
diff --git a/distro/pkg/deb/bird2.postinst b/distro/pkg/deb/bird2.postinst
new file mode 100644
index 00000000..8f85b15a
--- /dev/null
+++ b/distro/pkg/deb/bird2.postinst
@@ -0,0 +1,19 @@
+#!/bin/sh
+set -e
+
+if [ "$1" = "configure" ]; then
+
+    if ! getent passwd bird > /dev/null; then
+	adduser --quiet --system --group --no-create-home --home /run/bird bird
+    fi
+
+    dpkg-statoverride --list /etc/bird > /dev/null || dpkg-statoverride --update --add bird bird 0750 /etc/bird
+
+    ucf /usr/share/bird2/bird.conf /etc/bird/bird.conf
+    ucfr -f bird2 /etc/bird/bird.conf
+    dpkg-statoverride --list /etc/bird/bird.conf > /dev/null || dpkg-statoverride --update --add bird bird 0640 /etc/bird/bird.conf
+fi
+
+#DEBHELPER#
+
+exit 0
diff --git a/distro/pkg/deb/bird2.postrm b/distro/pkg/deb/bird2.postrm
new file mode 100644
index 00000000..ab03e6e6
--- /dev/null
+++ b/distro/pkg/deb/bird2.postrm
@@ -0,0 +1,26 @@
+#!/bin/sh
+set -e
+
+if test "$1" = "purge"; then
+
+    # Check if there is no collision of ownership of /etc/bird/bird.conf
+    if ! command -v ucf ucfr >/dev/null || ucfr bird2 /etc/bird/bird.conf 2>/dev/null; then
+	dpkg-statoverride --remove /etc/bird >/dev/null 2>/dev/null || true
+	dpkg-statoverride --remove /etc/bird/bird.conf >/dev/null 2>/dev/null || true
+
+	for ext in '~' '%' .bak .ucf-new .ucf-old .ucf-dist;  do
+	    rm -f /etc/bird/bird.conf$ext
+	done
+	rm -f /etc/bird/bird.conf
+	if command -v ucf ucfr >/dev/null; then
+	    ucf --purge /etc/bird/bird.conf
+	    ucfr --purge bird2 /etc/bird/bird.conf
+	fi
+
+	deluser --quiet bird > /dev/null || true
+    fi
+fi
+
+#DEBHELPER#
+
+exit 0
diff --git a/distro/pkg/deb/changelog b/distro/pkg/deb/changelog
new file mode 100644
index 00000000..d371bc06
--- /dev/null
+++ b/distro/pkg/deb/changelog
@@ -0,0 +1,5 @@
+bird2 ({{ version }}-cznic.{{ release }}) unstable; urgency=medium
+
+  * upstream package
+
+ -- Jakub Ružička <jakub.ruzicka@nic.cz>  Mon, 29 Mar 2021 14:15:50 +0000
diff --git a/distro/pkg/deb/compat b/distro/pkg/deb/compat
new file mode 100644
index 00000000..ec635144
--- /dev/null
+++ b/distro/pkg/deb/compat
@@ -0,0 +1 @@
+9
diff --git a/distro/pkg/deb/control b/distro/pkg/deb/control
new file mode 100644
index 00000000..4935c696
--- /dev/null
+++ b/distro/pkg/deb/control
@@ -0,0 +1,55 @@
+Source: bird2
+Section: net
+Priority: optional
+Build-Depends: bison,
+               debhelper,
+               docbook-xsl,
+               flex,
+               libncurses5-dev,
+               libreadline-dev | libreadline6-dev | libreadline5-dev,
+               libssh-gcrypt-dev,
+               linuxdoc-tools-latex,
+               m4,
+               opensp,
+               quilt,
+               texlive-latex-extra,
+               xsltproc
+Maintainer: Jakub Ružička <jakub.ruzicka@nic.cz>
+Uploaders: Ondřej Surý <ondrej@debian.org>
+Standards-Version: 4.3.0
+Vcs-Browser: https://salsa.debian.org/debian/bird2
+Vcs-Git: https://salsa.debian.org/debian/bird2.git
+Homepage: https://bird.network.cz/
+
+Package: bird2
+Architecture: kfreebsd-any linux-any
+Pre-Depends: init-system-helpers (>= 1.56~),
+             ${misc:Pre-Depends}
+Depends: adduser,
+         lsb-base,
+         ucf,
+         ${misc:Depends},
+         ${shlibs:Depends}
+Conflicts: bird
+Suggests: bird2-doc
+Description: Internet Routing Daemon
+ BIRD is an Internet routing daemon with full support for all the major
+ routing protocols. It allows redistribution between protocols with a
+ powerful route filtering syntax and an easy-to-use configuration
+ interface.
+ .
+ BIRD supports IPv4 and IPv6 versions of OSPF, RIP, BGP and Babel routing
+ protocols. It also supports supplementary protocols like BFD, RPKI-Router
+ and IPv6 router advertisements.
+
+Package: bird2-doc
+Architecture: all
+Section: doc
+Depends: ${misc:Depends}
+Description: Internet Routing Daemon - documentation
+ BIRD is an Internet routing daemon with full support for all the major
+ routing protocols. It allows redistribution between protocols with a
+ powerful route filtering syntax and an easy-to-use configuration
+ interface.
+ .
+ This package provides the user and developer documentation.
diff --git a/distro/pkg/deb/copyright b/distro/pkg/deb/copyright
new file mode 100644
index 00000000..7d3c391c
--- /dev/null
+++ b/distro/pkg/deb/copyright
@@ -0,0 +1,99 @@
+Format: https://www.debian.org/doc/packaging-manuals/copyright-format/1.0/
+Upstream-Name: bird
+Upstream-Contact: bird-users@network.cz
+Source: https://bird.network.cz
+
+Files: *
+Copyright: 1998-2008 Martin Mareš
+	   1998-2019 Ondřej Filip
+	   1998-2000 Pavel Machek
+	   2008-2019 Ondřej Zajíček
+	   2015-2019 Maria Matějka
+License: GPL-2+
+
+Files: lib/heap.h
+Copyright: 2001 Martin Mareš <mj@ucw.cz>
+	   2005 Tomáš Valla <tom@ucw.cz>
+License: LGPL-2+
+
+Files: lib/md5.c
+Copyright: 1993 Colin Plumb
+License: public-domain
+
+Files: lib/printf.c
+Copyright: 1991-1992 Lars Wirzenius
+	   1991-1992 Linus Torvalds
+	   1998-2000 Martin Mareš
+License: GPL-2
+
+Files: lib/sha*
+Copyright: 1998-2009 Free Software Foundation, Inc.
+	   2015-2016 Pavel Tvrdík
+	   2015-2016 Ondřej Zajíček
+License: GPL-2+
+
+Files: proto/babel/*
+Copyright: 2015-2016 Toke Høiland-Jørgensen
+	   2016-2018 Ondřej Zajíček
+License: GPL-2+
+
+Files: proto/rpki/*
+Copyright: 2015-2016 Pavel Tvrdík
+	   2016-2018 Ondřej Zajíček
+License: GPL-2+
+
+Files: debian/*
+Copyright: 2010-2013 Ondřej Surý <ondrej@debian.org>
+License: GPL-2+
+
+License: GPL-2+
+  This program is free software; you can redistribute it and/or modify
+  it under the terms of the GNU General Public License as published by
+  the Free Software Foundation; either version 2 of the License, or
+  (at your option) any later version.
+  .
+  This program is distributed in the hope that it will be useful,
+  but WITHOUT ANY WARRANTY; without even the implied warranty of
+  MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
+  GNU General Public License for more details.
+  .
+  You should have received a copy of the GNU General Public License
+  along with this program; if not, write to the Free Software
+  Foundation, Inc., 51 Franklin St, Fifth Floor, Boston, MA  02110-1301  USA
+  .
+  On Debian systems, the complete text of the GNU General Public License
+  version 2 can be found in `/usr/share/common-licenses/GPL-2'.
+
+License: GPL-2
+ This package is free software; you can redistribute it and/or modify
+ it under the terms of the GNU General Public License version 2 as
+ published by the Free Software Foundation.
+ .
+ This package is distributed in the hope that it will be useful,
+ but WITHOUT ANY WARRANTY; without even the implied warranty of
+ MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
+ GNU General Public License for more details.
+ .
+ You should have received a copy of the GNU General Public License
+ along with this package; if not, write to the Free Software
+ Foundation, Inc., 51 Franklin St, Fifth Floor, Boston, MA  02110-1301 USA
+ .
+ On Debian systems, the complete text of the GNU General Public License
+ version 2 can be found in `/usr/share/common-licenses/GPL-2'.
+
+License: LGPL-2+
+ This library is free software; you can redistribute it and/or
+ modify it under the terms of the GNU Library General Public
+ License as published by the Free Software Foundation; either
+ version 2 of the License, or (at your option) any later version.
+ .
+ This library is distributed in the hope that it will be useful,
+ but WITHOUT ANY WARRANTY; without even the implied warranty of
+ MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the GNU
+ Library General Public License for more details.
+ .
+ On Debian systems, the complete text of the GNU Lesser General Public
+ License version 2 can be found in `/usr/share/common-licenses/LGPL-2'.
+
+License: public-domain
+  This code is in the public domain; do with it what you wish.
diff --git a/distro/pkg/deb/envvars b/distro/pkg/deb/envvars
new file mode 100644
index 00000000..9ca9baa0
--- /dev/null
+++ b/distro/pkg/deb/envvars
@@ -0,0 +1,3 @@
+BIRD_RUN_USER=bird
+BIRD_RUN_GROUP=bird
+#BIRD_ARGS=
diff --git a/distro/pkg/deb/gbp.conf b/distro/pkg/deb/gbp.conf
new file mode 100644
index 00000000..f04b9f6e
--- /dev/null
+++ b/distro/pkg/deb/gbp.conf
@@ -0,0 +1,9 @@
+[DEFAULT]
+debian-branch = master
+debian-tag = debian/%(version)s
+upstream-branch = upstream
+upstream-tag = upstream/%(version)s
+pristine-tar = True
+
+[dch]
+meta = 1
diff --git a/distro/pkg/deb/patches/0001-Sync-the-linuxdoc-mangled-files-with-linuxdoc-tools_.patch b/distro/pkg/deb/patches/0001-Sync-the-linuxdoc-mangled-files-with-linuxdoc-tools_.patch
new file mode 100644
index 00000000..9ac96817
--- /dev/null
+++ b/distro/pkg/deb/patches/0001-Sync-the-linuxdoc-mangled-files-with-linuxdoc-tools_.patch
@@ -0,0 +1,1394 @@
+From: =?utf-8?b?T25kxZllaiBTdXLDvQ==?= <ondrej@debian.org>
+Date: Mon, 11 May 2020 10:27:06 +0200
+Subject: Sync the linuxdoc mangled files with linuxdoc-tools_0.9.73-2
+
+---
+ doc/LinuxDocTools.pm | 903 ++++++++++++++++++++++++++-------------------------
+ doc/sgml2html        |  77 +++--
+ doc/sgml2latex       |  77 +++--
+ doc/sgml2txt         |  77 +++--
+ 4 files changed, 611 insertions(+), 523 deletions(-)
+
+diff --git a/doc/LinuxDocTools.pm b/doc/LinuxDocTools.pm
+index d32f317..c035f62 100644
+--- a/doc/LinuxDocTools.pm
++++ b/doc/LinuxDocTools.pm
+@@ -1,21 +1,19 @@
+-#! /usr/bin/perl 
++#! /usr/bin/perl
+ #
+ #  LinuxDocTools.pm
+ #
+-#  $Id$
+-#
+-#  LinuxDoc-Tools driver core. This contains all the basic functionality
+-#  we need to control all other components.
+-#
+-#  � Copyright 1996, Cees de Groot.
+-#  � Copyright 2000, Taketoshi Sano
+-#
+-#  THIS VERSION HAS BEEN HACKED FOR BIRD BY MARTIN MARES
++#  LinuxDoc-Tools driver core. This contains all the basic
++#  functionality we need to control all other components.
+ #
++#  Copyright � 1996, Cees de Groot.
++#  Copyright � 2000, Taketoshi Sano
++#  Copyright � 2006-2020, Agustin Martin
++# -------------------------------------------------------------------
+ package LinuxDocTools;
+ 
+-require 5.004;
++require 5.006;
+ use strict;
++use LinuxDocTools::Data::Latin1ToSgml qw{ldt_latin1tosgml};
+ 
+ =head1 NAME
+ 
+@@ -33,8 +31,8 @@ LinuxDocTools - SGML conversion utilities for LinuxDoc DTD.
+ =head1 DESCRIPTION
+ 
+ The LinuxDocTools package encapsulates all the functionality offered by
+-LinuxDoc-Tools. It is used, of course, by LinuxDoc-Tools; 
+-but the encapsulation should provide for a simple interface for other users as well. 
++LinuxDoc-Tools. It is used, of course, by LinuxDoc-Tools;
++but the encapsulation should provide for a simple interface for other users as well.
+ 
+ =head1 FUNCTIONS
+ 
+@@ -42,21 +40,24 @@ but the encapsulation should provide for a simple interface for other users as w
+ 
+ =cut
+ 
+-use DirHandle;
+-use File::Basename;
+-use File::Find;
+ use File::Copy;
+-use FileHandle;
+-use IPC::Open2;
+-use Cwd;
++use File::Temp qw(tempdir);
++use File::Basename qw(fileparse);
+ use LinuxDocTools::Lang;
+-use LinuxDocTools::Utils qw(process_options usage cleanup trap_signals remove_tmpfiles create_temp);
++use LinuxDocTools::Utils qw(
++  cleanup
++  create_temp
++  ldt_log
++  remove_tmpfiles
++  trap_signals
++  usage
++  );
+ use LinuxDocTools::Vars;
+ 
+ sub BEGIN
+ {
+   #
+-  #  Make sure we're always looking here. Note that "use lib" adds 
++  #  Make sure we're always looking here. Note that "use lib" adds
+   #  on the front of the search path, so we first push dist, then
+   #  site, so that site is searched first.
+   #
+@@ -64,54 +65,127 @@ sub BEGIN
+   use lib "$main::DataDir/site";
+ }
+ 
++# -------------------------------------------------------------------
++sub ldt_searchfile {
++  # -----------------------------------------------------------------
++  # Look for a readable file in the locations. Return first math.
++  # -----------------------------------------------------------------
++  my $files = shift;
++  foreach my $file  ( @$files ){
++    return $file if -r $file;
++  }
++}
++
++# -------------------------------------------------------------------
++sub ldt_getdtd_v1 {
++  # -----------------------------------------------------------------
++  # Get the dtd
++  # -----------------------------------------------------------------
++  my $file         = shift;
++  my $error_header = "LinuxdocTools::ldt_getdtd_v1";
++  my $dtd;
++
++  open ( my $FILE, "< $file")
++    or die "$error_header: Could not open \"$file\" for reading. Aborting ...\n";
++
++  while ( <$FILE> ) {
++    tr/A-Z/a-z/;
++    # check for [<!doctype ... system] type definition
++    if ( /<!doctype\s*(\w*)\s*system/ ) {
++      $dtd = $1;
++      last;
++      # check for <!doctype ... PUBLIC ... DTD ...
++    } elsif ( /<!doctype\s*\w*\s*public\s*.*\/\/dtd\s*(\w*)/mi ) {
++      $dtd = $1;
++      last;
++      # check for <!doctype ...
++      #          PUBLIC  ... DTD ...
++      # (multi-line version)
++    } elsif ( /<!doctype\s*(\w*)/ ) {
++      $dtd = "precheck";
++      next;
++    } elsif ( /\s*public\s*.*\/\/dtd\s*(\w*)/ && $dtd eq "precheck" ) {
++      $dtd = $1;
++      last;
++    }
++  }
++  close $FILE;
++
++  return $dtd;
++}
++
++# -------------------------------------------------------------------
++sub ldt_getdtd_v2 {
++  # -----------------------------------------------------------------
++  # Second way of getting dtd, fron nsgmls output.
++  # -----------------------------------------------------------------
++  my $preaspout    = shift;
++  my $error_header = "LinuxdocTools::ldt_getdtd_v2";
++  my $dtd2;
++
++  open (my $TMP,"< $preaspout")
++    or die "%error_header: Could not open $preaspout for reading. Aborting ...\n";
++  while ( defined ($dtd2 = <$TMP>) && ! ( $dtd2 =~ /^\(/) ) { };
++  close $TMP;
++  $dtd2 =~ s/^\(//;
++  $dtd2 =~ tr/A-Z/a-z/;
++  chomp $dtd2;
++  return $dtd2;
++}
++
++# -------------------------------------------------------------------
++
+ =item LinuxDocTools::init
+ 
+ Takes care of initialization of package-global variables (which are actually
+ defined in L<LinuxDocTools::Vars>). The package-global variables are I<$global>,
+ a reference to a hash containing numerous settings, I<%Formats>, a hash
+ containing all the formats, and I<%FmtList>, a hash containing the currently
+-active formats for help texts. 
++active formats for help texts.
+ 
+ Apart from this, C<LinuxDocTools::init> also finds all distributed and site-local
+ formatting backends and C<require>s them.
+ 
+ =cut
+ 
+-sub init
+-{
++# -------------------------------------------------------------------
++sub init {
++# -------------------------------------------------------------------
+   trap_signals;
+ 
+-  #
+-  #  Register the ``global'' pseudoformat. Apart from the global settings,
+-  #  we also use $global to keep the global variable name space clean; 
+-  #  everything that we need to provide to other modules is stuffed
+-  #  into $global.
+-  #
+-  $global = {};
+-  $global->{NAME} = "global";
+-  $global->{HELP} = "";
+-  $global->{OPTIONS} = [
+-    { option => "backend", type => "l",
+-      'values' => [ "html", "info", "latex", 
+-			"lyx", "rtf", "txt", "check" ],
+-	 short => "B" },
+-    { option => "papersize", type => "l",
+-      'values' => [ "a4", "letter" ], short => "p" },
+-    { option => "language",  type => "l",
+-      'values' => [ @LinuxDocTools::Lang::Languages ], short => "l" },
+-    { option => "charset",   type => "l",
+-      'values' => [ "latin", "ascii", "nippon", "euc-kr" ], short => "c" },
+-    { option => "style",     type => "s", short => "S" },
+-    { option => "tabsize",   type => "i", short => "t" },
+-#    { option => "verbose",   type => "f", short => "v" },
+-    { option => "debug",     type => "f", short => "d" },
+-    { option => "define",    type => "s", short => "D" },
+-    { option => "include",   type => "s", short => "i" },
+-    { option => "pass",      type => "s", short => "P" }
+-  ];
++  # Register the ``global'' pseudoformat. Apart from the global settings, we
++  # also use $global to keep the global variable name space clean everything
++  # that we need to provide to other modules is stuffed into $global.
++  $global              = {};
++  $global->{NAME}      = "global";
++  $global->{HELP}      = "";
++  $global->{OPTIONS}   = [
++			  { option => "backend",
++			    type => "l",
++			    'values' => [ "html", "info", "latex", "lyx", "rtf", "txt", "check" ],
++			    short => "B" },
++			  { option => "papersize",
++			    type => "l",
++			    'values' => [ "a4", "letter" ],
++			    short => "p" },
++			  { option => "language",
++			    type => "l",
++			    'values' => [ @LinuxDocTools::Lang::Languages ],
++			    short => "l" },
++			  { option => "charset",   type => "l",
++			    'values' => [ "latin", "ascii", "nippon", "euc-kr" , "utf-8"],
++			    short => "c" },
++			  { option => "style",     type => "s", short => "S" },
++			  { option => "tabsize",   type => "i", short => "t" },
++			  # { option => "verbose",   type => "f", short => "v" },
++			  { option => "debug",     type => "f", short => "d" },
++			  { option => "define",    type => "s", short => "D" },
++			  { option => "include",   type => "s", short => "i" },
++			  { option => "pass",      type => "s", short => "P" }
++			  ];
+   $global->{backend}   = "linuxdoc";
+   $global->{papersize} = "a4";
+-  $global->{language}  = "en";
++  $global->{language}  = '';
+   $global->{charset}   = "ascii";
+   $global->{style}     = "";
+   $global->{tabsize}   = 8;
+@@ -119,11 +193,24 @@ sub init
+   $global->{define}    = "";
+   $global->{debug}     = 0;
+   $global->{include}   = "";
++  $global->{logfile}   = '';
+   $global->{pass}      = "";
+   $global->{InFiles}   = [];
++  $global->{fmtlist}   = "";            # List of loaded fmt files
+   $Formats{$global->{NAME}} = $global;	# All formats we know.
+   $FmtList{$global->{NAME}} = $global;  # List of formats for help msgs.
+ 
++  $global->{sgmlpre}   = "$main::AuxBinDir/sgmlpre";
++  my $error_header     = "LinuxdocTools::init";
++
++  if ( -e "/etc/papersize" ){
++    open (my $PAPERSIZE,"< /etc/papersize") ||
++      die "$error_header: Count not open \"/etc/papersize\" for reading\n";
++    chomp (my $paper = <$PAPERSIZE>);
++    $global->{papersize} = "letter" if ( $paper eq "letter");
++    close $PAPERSIZE;
++  }
++
+   # automatic language detection: disabled by default
+   # {
+   #    my $lang;
+@@ -137,42 +224,39 @@ sub init
+   #     }
+   # }
+ 
+-  #
+-  #  Used when the format is "global" (from sgmlcheck).
+-  #
++  # -------------------------------------------------------------------
+   $global->{preNSGMLS} = sub {
+-    $global->{NsgmlsOpts} .= " -s ";
++    # -----------------------------------------------------------------
++    #  Define a fallback preNSGMLS. Used when the format is "global"
++    #  (from sgmlcheck).
++    # -----------------------------------------------------------------
++    $global->{NsgmlsOpts}   .= " -s ";
+     $global->{NsgmlsPrePipe} = "cat $global->{file}";
+   };
+ 
+-  #
+-  #  Build up the list of formatters.
+-  #
+-  my $savdir = cwd;
+-  my %Locs;
+-  chdir "$main::DataDir/dist";
+-  my $dir = new DirHandle(".");
+-  die "Unable to read directory $main::DataDir/dist: $!" unless defined($dir);
+-  foreach my $fmt (grep(/^fmt_.*\.pl$/, $dir->read()))
+-  {
+-    $Locs{$fmt} = "dist";
+-  }
+-  $dir->close();
+-  chdir "$main::DataDir/site";
+-  $dir = new DirHandle(".");
+-  die "Unable to read directory $main::DataDir/site: $!" unless defined($dir);
+-  foreach my $fmt (grep(/^fmt_.*\.pl$/, $dir->read()))
+-  {
+-    $Locs{$fmt} = "site";
++  # We need to load all fmt files here, so the allowed options for all
++  # format are put into $global and a complete usage message is built,
++  # including options for all formats.
++  my %locations = ();
++  foreach my $path ("$main::DataDir/site",
++		    "$main::DataDir/dist",
++		    "$main::DataDir/fmt"){
++    foreach my $location (<$path/fmt_*.pl>){
++      my $fmt =  $location;
++      $fmt    =~ s/^.*_//;
++      $fmt    =~ s/\.pl$//;
++      $locations{$fmt} = $location unless defined $locations{$fmt};
++    }
+   }
+-  $dir->close();
+-  foreach my $fmt (keys %Locs)
+-  {
+-    require $fmt;
++
++  foreach my $fmt ( keys %locations ){
++    $global->{fmtlist}   .= "  Loading $locations{$fmt}\n";
++    require $locations{$fmt};
+   }
+-  chdir $savdir;
+ }
+ 
++# ------------------------------------------------------------------------
++
+ =item LinuxDocTools::process_options ($0, @ARGV)
+ 
+ This function contains all initialization that is bound to the current
+@@ -181,91 +265,113 @@ should be used (ld2txt activates the I<txt> backend) and parses the
+ options array. It returns an array of filenames it encountered during
+ option processing.
+ 
+-As a side effect, the environment variables I<SGMLDECL> and 
+-I<SGML_CATALOG_FILES> are modified.
++As a side effect, the environment variable I<SGML_CATALOG_FILES> is
++modified and, once I<$global->{format}> is known, I<SGMLDECL> is set.
+ 
+ =cut
+ 
+-sub process_options
+-{
+-  my $progname = shift;
+-  my @args = @_;
++# -------------------------------------------------------------------
++sub process_options {
++  # -----------------------------------------------------------------
++  my $progname  = shift;
++  my @tmpargs   = @_;
++  my @args      = ();
++  my $format    = '';
++  my $msgheader = "LinuxDocTools::process_options";
++
++  # Try getting the format. We need to do this here so process_options
++  # knows which is the format and which format options are allowed
++
++  # First, see if we have an explicit backend option by looping over command line.
++  # Do not shift in the while condition itself, 0 in options like '-s 0' will
++  # otherwise stop looping
++  while ( @tmpargs ){
++    $_ = shift @tmpargs;
++    if ( s/--backend=// ){
++      $format = $_;
++    } elsif ( $_ eq "-B" ){
++      $format = shift @tmpargs;
++    } else {
++      push @args, $_;
++    }
++  }
+ 
+-  #
+-  #  Deduce the format from the caller's file name
+-  #
+-  my ($format, $dummy1, $dummy2) = fileparse ($progname, "");
+-  $global->{myname} = $format;
+-  $format =~ s/sgml2*(.*)/$1/;
++  unless ( $format ){
++    my ($tmpfmt, $dummy1, $dummy2) = fileparse($progname, "");
++    if ( $tmpfmt =~ s/^sgml2// ) {       # Calling program through sgml2xx symlinks
++      $format = $tmpfmt;
++    } elsif ( $tmpfmt eq "sgmlcheck" ) { # Calling program through sgmlcheck symlink
++      $format = "global";
++    }
++  }
+ 
+-  #
+-  # check the option "--backend / -B"
+-  #
+-  if ($format eq "linuxdoc") {
+-      my @backends = @args;
+-      my $arg;
+-      while (@backends) {
+-         $arg = shift @backends;
+-         if ($arg eq "-B") {
+-                $arg = shift @backends;
+-                $format = $arg;
+-                last;
+-	 }
+-         if ( $arg =~ s/--backend=(.*)/$1/ ) {
+-                $format = $arg;
+-                last;
+-         }
++  if ( $format ) {
++    if ( $format eq "check" ){
++      $format = "global";
++    } elsif ( $format eq "latex" ){
++      $format = "latex2e";
++    }
++    $FmtList{$format} = $Formats{$format} or
++      usage("$format: Unknown format");
++    $global->{format} = $format;
++  } else {
++    usage("");
++  }
++
++  # Parse all the options from @args, and return files.
++  my @files    = LinuxDocTools::Utils::process_options(@args);
++
++  # Check the number of given files
++  $#files > -1 || usage("No filenames given");
++
++  # Normalize language string
++  $global->{language} = Any2ISO($global->{language})
++    if ( defined $global->{language} );
++
++  # Fine tune japanese and korean charsets when not utf-8
++  if ($global->{charset} ne "utf-8") {
++    if ($global->{language} eq "ja" ){
++      $global->{charset} = "nippon";
++    } elsif ($global->{language} eq "ko"){
++      if ($global->{format} eq "groff") {
++	$global->{charset} = "latin1";
++      } else {
++	$global->{charset} = "euc-kr";
+       }
++    }
+   }
+ 
+-  $format = "global" if $format eq "check";
+-  usage ("") if $format eq "linuxdoc";
+-  $format = "latex2e" if $format eq "latex";
+-  $FmtList{$format} = $Formats{$format} or 
+-     usage ("$global->{myname}: unknown format");
+-  $global->{format} = $format;
++  # Setup the SGML environment.
++  my @sgmlcatalogs =
++    (# SGML iso-entities catalog location in Debian sgml-data package
++     "$main::isoentities_prefix/share/sgml/entities/sgml-iso-entities-8879.1986/catalog",
++     # SGML iso-entities catalog location in ArchLinux, Fedora and Gentoo
++     "$main::isoentities_prefix/share/sgml/sgml-iso-entities-8879.1986/catalog",
++     # SGML iso-entities catalog location when installed from linuxdoc-tools
++     "$main::isoentities_prefix/share/sgml/iso-entities-8879.1986/iso-entities.cat",
++     # dtd/catalog for SGML-Tools
++     "$main::DataDir/linuxdoc-tools.catalog",
++     # The super catalog
++     "/etc/sgml/catalog");
+ 
+-  #
+-  #  Parse all the options.
+-  #
+-  my @files = LinuxDocTools::Utils::process_options (@args);
+-  $global->{language} = Any2ISO ($global->{language});
+-  #
+-  # check the number of given files 
+-  $#files > -1 || usage ("no filenames given");
++  @sgmlcatalogs = ($ENV{SGML_CATALOG_FILES}, @sgmlcatalogs) if defined $ENV{SGML_CATALOG_FILES};
+ 
+-  #
+-  #  Setup the SGML environment.
+-  #  (Note that Debian package rewrite path to catalog of
+-  #   iso-entities using debian/rules so that it can use 
+-  #   entities from sgml-data pacakge.  debian/rules also
+-  #   removes iso-entites sub directory after doing make install.)
+-  #
+-  $ENV{SGML_CATALOG_FILES} .= (defined $ENV{SGML_CATALOG_FILES} ? ":" : "") .
+-     "$main::prefix/share/sgml/sgml-iso-entities-8879.1986/catalog:" .
+-     "$main::prefix/share/sgml/entities/sgml-iso-entities-8879.1986/catalog";
+-  $ENV{SGML_CATALOG_FILES} .= ":$main::DataDir/linuxdoc-tools.catalog";
+-  $ENV{SGML_CATALOG_FILES} .= ":$main::/etc/sgml.catalog";
+-  if (-f "$main::DataDir/dtd/$format.dcl")
+-    {
+-      $ENV{SGMLDECL} = "$main::DataDir/dtd/$format.dcl";
+-    }
+-  elsif (-f "$main::DataDir/dtd/$global->{style}.dcl")
+-    {
+-      $ENV{SGMLDECL} = "$main::DataDir/dtd/$global->{style}.dcl";
+-    }
+-  elsif (-f "$main::DataDir/dtd/sgml.dcl")
+-    {
+-      $ENV{SGMLDECL} = "$main::DataDir/dtd/sgml.dcl";
+-    }
++  $ENV{SGML_CATALOG_FILES} = join(':', @sgmlcatalogs);
+ 
+-  #
+-  #  OK. Give the list of files we distilled from the options
+-  #  back to the caller.
+-  #
++  # Set to one of these if readable, nil otherwise
++  $ENV{SGMLDECL} = ldt_searchfile(["$main::DataDir/dtd/$global->{format}.dcl",
++				   "$main::DataDir/dtd/$global->{style}.dcl",
++				   "$main::DataDir/dtd/sgml.dcl"]);
++
++  # Show the list of loaded fmt_*.pl files if debugging
++  print STDERR $global->{fmtlist} if $global->{debug};
++
++  # Return the list of files to be processed
+   return @files;
+ }
+ 
++# -------------------------------------------------------------------
++
+ =item LinuxDocTools::process_file
+ 
+ With all the configuration done, this routine will take a single filename
+@@ -294,330 +400,243 @@ etcetera. See the code for details.
+ 
+ =cut
+ 
+-sub process_file
+-{
+-  my $file = shift (@_);
+-  my $saved_umask = umask;
++# -------------------------------------------------------------------
++sub process_file {
++  # ----------------------------------------------------------------
++  my $file            = $global->{origfile} = shift (@_);
++  my $saved_umask     = umask;
++  my $error_header    = "LinuxdocTools::process_file";
++  my $fmtopts         = $Formats{$global->{format}};
+ 
+   print "Processing file $file\n";
+   umask 0077;
+ 
+-  my ($filename, $filepath, $filesuffix) = fileparse ($file, "\.sgml");
+-  my $tmpnam = $filepath . '/' . $filename;
+-  $file = $tmpnam . $filesuffix;
+-  -f $file || $file =~ /.*.sgml$/ || ($file .= '.sgml');
+-  -f $file || ($file = $tmpnam . '.SGML');
+-  -f $file || die "Cannot find $file\n";
++  my ($filename, $filepath, $filesuffix) = fileparse($file, "\.sgml");
+   $global->{filename} = $filename;
+-  $global->{file} = $file;
+   $global->{filepath} = $filepath;
++  $global->{file}     = ldt_searchfile(["$filepath/$filename.sgml",
++					"$filepath/$filename.SGML"])
++    or die "$error_header: Cannot find $file. Aborting ...\n";
++
++  my $dtd = ldt_getdtd_v1("$global->{file}");
++  print STDERR "DTD: " . $dtd . "\n" if $global->{debug};
++
++  # -- Prepare temporary directory
++  my $tmpdir    = $ENV{'TMPDIR'} || '/tmp';
++  $tmpdir       = tempdir("linuxdoc-tools.XXXXXXXXXX", DIR => "$tmpdir");
++
++  # -- Set common base name for temp files and temp file names
++  my $tmpbase   = $global->{tmpbase} = $tmpdir . '/sgmltmp.' . $filename;
++  my $precmdout = "$tmpbase.01.precmdout";
++  my $nsgmlsout = "$tmpbase.02.nsgmlsout";   # Was $tmpbase.1
++  my $preaspout = "$tmpbase.03.preaspout";   # Was $tmpbase.2
++  my $aspout    = "$tmpbase.04.aspout";      # Was $tmpbase.3
++
++  # -- Set $global->{logfile} and initialize logfile.
++  $global->{logfile} = "$tmpbase.$global->{format}.log";
++  open (my $LOGFILE, ">", "$global->{logfile}")
++    or die "$error_header: Could not open \"$global->{logfile}\" logfile for write.\n";
++  print $LOGFILE "--- Opening \"$global->{logfile}\" logfile ---\n";
++  close $LOGFILE;
++
++  # -- Write info about some global options
++  ldt_log "--- Begin: Info about global options";
++  foreach ( sort keys %$global ){
++    next if m/fmtlist|InFiles|OPTIONS/;
++    ldt_log "$_:  $global->{$_}";
++  }
++  ldt_log "--- End: Info about global options";
++  ldt_log "$global->{fmtlist}";
++
++  # -- Write info about some backend options
++  ldt_log "--- Begin: Info about backend options";
++  foreach ( sort keys %$fmtopts ){
++    next if m/fmtlist|InFiles|OPTIONS/;
++    ldt_log "$_:  $fmtopts->{$_}";
++  }
++  ldt_log "--- End: Info about backend options";
+ 
+-  my $tmp = new FileHandle "<$file";
+-  my $dtd;
+-  while ( <$tmp> )
+-    {
+-      tr/A-Z/a-z/;
+-      # check for [<!doctype ... system] type definition
+-      if ( /<!doctype\s*(\w*)\s*system/ )
+-        {
+-          $dtd = $1;
+-          last;
+-        }
+-      # check for <!doctype ... PUBLIC ... DTD ...
+-      if ( /<!doctype\s*\w*\s*public\s*.*\/\/dtd\s*(\w*)/mi )
+-        {
+-          $dtd = $1;
+-          last;
+-        }
+-      # check for <!doctype ...
+-      #          PUBLIC  ... DTD ...
+-      # (multi-line version)
+-      if ( /<!doctype\s*(\w*)/ )
+-        {
+-          $dtd = "precheck";
+-          next;
+-        }
+-      if ( /\s*public\s*.*\/\/dtd\s*(\w*)/ && $dtd eq "precheck" )
+-        {
+-          $dtd = $1;
+-          last;
+-        }
+-    }
+-  $tmp->close;
+-  if ( $global->{debug} )
+-    {
+-      print "DTD: " . $dtd . "\n";
++  # Set up the preprocessing command. Conditionals have to be
++  # handled here until they can be moved into the DTD, otherwise
++  # a validating SGML parser will choke on them.
++
++  # -- Check if output option for latex is pdf or not
++  if ($global->{format} eq "latex2e") {
++    if ($Formats{$global->{format}}{output} eq "pdf") {
++      $global->{define} .= " pdflatex=yes";
+     }
+-  $global->{dtd} = $dtd;
++  }
+ 
+-  # prepare temporary directory
+-  my $tmpdir = $ENV{'TMPDIR'} || '/tmp';
+-  $tmpdir = $tmpdir . '/' . 'linuxdoc-dir-' . $$;
+-  mkdir ($tmpdir, 0700) ||
+-   die " - temporary files can not be created, aborted - \n";
++  # -- Set the actual pre-processing command
++  my($precmd) = "| $global->{sgmlpre} output=$global->{format} $global->{define}";
++  ldt_log "  ${error_header}::precmd:\n    $precmd";
+ 
+-  my $tmpbase = $global->{tmpbase} = $tmpdir . '/sgmltmp.' . $filename;
++  # -- Make sure path of file to be processed is in SGML_SEARCH_PATH
+   $ENV{"SGML_SEARCH_PATH"} .= ":$filepath";
+ 
+-  #
+-  # Set up the preprocessing command.  Conditionals have to be
+-  # handled here until they can be moved into the DTD, otherwise
+-  # a validating SGML parser will choke on them.
+-  #
+-  # check if output option for latex is pdf or not
+-  if ($global->{format} eq "latex2e")
+-    {
+-      if ($Formats{$global->{format}}{output} eq "pdf")
+-        {
+-          $global->{define} .= " pdflatex=yes";
+-        }
+-    }
+-  #
++  # -- You can hack $NsgmlsOpts here, etcetera.
++  $global->{NsgmlsOpts}   .= "-D $main::prefix/share/sgml -D $main::DataDir";
++  $global->{NsgmlsOpts}   .= "-i$global->{include}" if ($global->{include});
++
++  # If a preNSGMLS function is defined in the fmt file, pipe its output to $FILE,
++  # otherwise just open $global->{file} as $IFILE
++  # -----------------------------------------------------------------
++  ldt_log "- PreNsgmls stage started.";
++  my $IFILE;
++  if ( defined $Formats{$global->{format}}{preNSGMLS} ) {
++    $global->{NsgmlsPrePipe} = &{$Formats{$global->{format}}{preNSGMLS}};
++    ldt_log  "  ${error_header}::NsgmlsPrePipe: $global->{NsgmlsPrePipe} |";
++    open ($IFILE,"$global->{NsgmlsPrePipe} |")
++      || die "$error_header: Could not open pipe from $global->{NsgmlsPrePipe}. Aborting ...\n";
++  } else {
++    ldt_log "  ${error_header}: No prepipe. Just opening \"$global->{file}\" for read";
++    open ($IFILE,"< $global->{file}")
++      || die "$error_header: Could not open $global->{file} for reading. Aborting ...\n";
++  }
+ 
+-  local $ENV{PATH} = "$ENV{PATH}:/usr/lib/linuxdoc-tools";
+-  my($precmd) = "|sgmlpre output=$global->{format} $global->{define}";
++  # -- Create a temp file with $precmd output
++  my $precmd_command    = "$precmd > $precmdout";
++  ldt_log "  ${error_header}::precmd_command:\n    $precmd_command";
+ 
+-  #
+-  #  You can hack $NsgmlsOpts here, etcetera.
+-  #
+-  $global->{NsgmlsOpts} .= "-D $main::prefix/share/sgml -D $main::DataDir";
+-  $global->{NsgmlsOpts} .= "-i$global->{include}" if ($global->{include});
+-  $global->{NsgmlsPrePipe} = "NOTHING";
+-  if ( defined $Formats{$global->{format}}{preNSGMLS} )
+-    {
+-      $global->{NsgmlsPrePipe} = &{$Formats{$global->{format}}{preNSGMLS}};
+-    }
++  open (my $PRECMDOUT, "$precmd_command")
++    or die "$error_header: Could not open pipe to $precmdout. Aborting ...\n";
+ 
+-  #
+-  #  Run the prepocessor and nsgmls.
+-  #
+-  my ($ifile, $writensgmls);
++  # -- Convert latin1 chars to sgml entities for html backend
++  if ( $global->{format} eq "html"
++       && $global->{charset} eq "latin"  ) {
++    ldt_log "  ${error_header}: Converting latin1 chars to sgml entities for html backend";
++    print $PRECMDOUT ldt_latin1tosgml($IFILE);
++  } else {
++    copy($IFILE,$PRECMDOUT);
++  }
+ 
+-  if ($global->{NsgmlsPrePipe} eq "NOTHING")
+-    {
+-      $ifile = new FileHandle $file;
+-    }
+-  else
+-    {
+-      $ifile = new FileHandle "$global->{NsgmlsPrePipe}|";
+-    }
++  close $IFILE;
++  close $PRECMDOUT;
++  ldt_log "- PreNsgmls stage finished.";
+ 
+-  create_temp("$tmpbase.1");
+-  $writensgmls = new FileHandle
+-      "$precmd|$main::progs->{NSGMLS} $global->{NsgmlsOpts} $ENV{SGMLDECL} >\"$tmpbase.1\"";
+-  if ($global->{charset} eq "latin")
+-    {
+-      while (<$ifile>) 
+-        {
+-	  # Outline these commands later on - CdG
+-	  #change latin1 characters to SGML
+-	  #by Farzad Farid, adapted by Greg Hankins
+-	  s/�/\&Agrave;/g;
+-	  s/�/\&Aacute;/g;
+-	  s/�/\&Acirc;/g;
+-	  s/�/\&Atilde;/g;
+-	  s/�/\&Auml;/g;
+-	  s/�/\&Aring;/g;
+-	  s/�/\&AElig;/g;
+-	  s/�/\&Ccedil;/g;
+-	  s/�/\&Egrave;/g;
+-	  s/�/\&Eacute;/g;
+-	  s/�/\&Ecirc;/g;
+-	  s/�/\&Euml;/g;
+-	  s/�/\&Igrave;/g;
+-	  s/�/\&Iacute;/g;
+-	  s/�/\&Icirc;/g;
+-	  s/�/\&Iuml;/g;
+-	  s/�/\&Ntilde;/g;
+-	  s/�/\&Ograve;/g;
+-	  s/�/\&Oacute;/g;
+-	  s/�/\&Ocirc;/g;
+-	  s/�/\&Otilde;/g;
+-	  s/�/\&Ouml;/g;
+-	  s/�/\&Oslash;/g;
+-	  s/�/\&Ugrave;/g;
+-	  s/�/\&Uacute;/g;
+-	  s/�/\&Ucirc;/g;
+-	  s/�/\&Uuml;/g;
+-	  s/�/\&Yacute;/g;
+-	  s/�/\&THORN;/g;
+-	  s/�/\&szlig;/g;
+-	  s/�/\&agrave;/g;
+-	  s/�/\&aacute;/g;
+-	  s/�/\&acirc;/g;
+-	  s/�/\&atilde;/g;
+-	  s/�/\&auml;/g;
+-	  s/�/\&aring;/g;
+-	  s/�/\&aelig;/g;
+-	  s/�/\&ccedil;/g;
+-	  s/�/\&egrave;/g;
+-	  s/�/\&eacute;/g;
+-	  s/�/\&ecirc;/g;
+-	  s/�/\&euml;/g;
+-	  s/�/\&igrave;/g;
+-	  s/�/\&iacute;/g;
+-	  s/�/\&icirc;/g;
+-	  s/�/\&iuml;/g;
+-	  s/�/\&mu;/g;
+-	  s/�/\&eth;/g;
+-	  s/�/\&ntilde;/g;
+-	  s/�/\&ograve;/g;
+-	  s/�/\&oacute;/g;
+-	  s/�/\&ocirc;/g;
+-	  s/�/\&otilde;/g;
+-	  s/�/\&ouml;/g;
+-	  s/�/\&oslash;/g;
+-	  s/�/\&ugrave;/g;
+-	  s/�/\&uacute;/g;
+-	  s/�/\&ucirc;/g;
+-	  s/�/\&uuml;/g;
+-	  s/�/\&yacute;/g;
+-	  s/�/\&thorn;/g;
+-	  s/�/\&yuml;/g;
+-          print $writensgmls $_;
+-	}
+-    }
+-  else
+-    {
+-      while (<$ifile>)
+-        {
+-          print $writensgmls $_;
+-	}
+-    }
+-  $ifile->close;
+-  $writensgmls->close;
+-        
+-  #
+-  #  Special case: if format is global, we're just checking.
+-  #
+-  $global->{format} eq "global" && cleanup;
++  ldt_log "- Nsgmls stage started.";
+ 
+-  #
+-  #  If the output file is empty, something went wrong.
+-  #
+-  ! -e "$tmpbase.1" and die "can't create file - exiting";
+-  -z "$tmpbase.1" and die "SGML parsing error - exiting";
+-  if ( $global->{debug} )
+-    {
+-      print "Nsgmls stage finished.\n";
+-    }
++  # -- Pass apropriate envvars to nsgmls to better deal with utf-8
++  my $NSGMLS_envvars = ($global->{charset} eq "utf-8")
++    ? "SP_CHARSET_FIXED=yes SP_ENCODING=utf-8" : "";
++
++  # -- Process with nsgmls.
++  my $nsgmls_command = "$NSGMLS_envvars $main::progs->{NSGMLS} $global->{NsgmlsOpts} $ENV{SGMLDECL} $precmdout > $nsgmlsout";
++  ldt_log "  ${error_header}::nsgmls_command:\n    $nsgmls_command";
++  system($nsgmls_command) == 0
++    or die "${error_header}: Error: \"$nsgmls_command\" failed with exit status: ",$? >> 8,"\n";
++
++  #  -- Special case: if format is global, we're just checking.
++  cleanup if ( $global->{format} eq "global");
++
++  # -- If output file does not exists or is empty, something went wrong.
++  if ( ! -e "$nsgmlsout" ) {
++    die "$error_header: Can't create file $nsgmlsout. Aborting ...\n";
++  } elsif ( -z "$nsgmlsout" ){
++    die "$error_header: $nsgmlsout empty, SGML parsing error. Aborting ...\n";
++  }
++
++  print "- Nsgmls stage finished.\n" if $global->{debug};
++  ldt_log "- Nsgmls stage finished.";
+ 
+-  #
+   #  If a preASP stage is defined, let the format handle it.
+-  #  
+-  #  preASP ($inhandle, $outhandle);
+-  #
+-  my $inpreasp = new FileHandle "<$tmpbase.1";
+-  my $outpreasp = new FileHandle "$tmpbase.2",O_WRONLY|O_CREAT|O_EXCL,0600;
+-  if (defined $Formats{$global->{format}}{preASP})
+-    {
+-      &{$Formats{$global->{format}}{preASP}}($inpreasp, $outpreasp) == 0 or
+-       die "error pre-processing $global->{format}.\n";
+-    }  
+-  else
+-    {
+-      copy ($inpreasp, $outpreasp);
+-    }
+-  $inpreasp->close;
+-  $outpreasp->close;
+-  ! -e "$tmpbase.2" and die "can't create file - exiting";
++  #  --------------------------------------------------------
++  ldt_log "- PreASP stage started.";
++  open (my $PREASP_IN, "< $nsgmlsout")
++    or die "$error_header: Could not open $nsgmlsout for reading. Aborting ...\n";
++  open (my $PREASP_OUT, "> $preaspout")
++    or die "$error_header: Could not open $preaspout for writing. Aborting ...\n";
++
++  if (defined $Formats{$global->{format}}{preASP}) {
++    # Usage: preASP ($INHANDLE, $OUTHANDLE);
++    &{$Formats{$global->{format}}{preASP}}($PREASP_IN, $PREASP_OUT) == 0
++      or die "$error_header: Error pre-processing $global->{format}.\n";
++  } else {
++    copy ($PREASP_IN, $PREASP_OUT);
++  }
+ 
+-  if ( $global->{debug} )
+-    {
+-      print "PreASP stage finished.\n";
+-    }
++  close $PREASP_IN;
++  close $PREASP_OUT;
++
++  die "$error_header: Can't create $preaspout file. Aborting ...\n"
++    unless -e "$preaspout";
++
++  print "- PreASP stage finished.\n" if ( $global->{debug} );
++  ldt_log "- PreASP stage finished.";
++
++  # Run sgmlsasp, with an optional style if specified.
++  # -----------------------------------------------------------
++  ldt_log "- ASP stage started.";
++  my $dtd2 = ldt_getdtd_v2($preaspout)
++    or die "$error_header: Could not read dtd from $preaspout. Aborting ...\n";
++
++  ldt_log "  $error_header: dtd_v1: $dtd, dtd_v2: $dtd2, both must match, dtd_v2 prevails";
++  unless ( $dtd eq $dtd2 ){
++    print STDERR "Warning: Two different values for dtd, dtd1: $dtd, dtd2: $dtd2\n";
++    $dtd = $dtd2;
++  }
++
++  $global->{'dtd'} = $dtd;
+ 
+-  #
+-  #  Run sgmlsasp, with an optional style if specified.
+-  #
+   #  Search order:
+   #  - datadir/site/<dtd>/<format>
+   #  - datadir/dist/<dtd>/<format>
+-  #  So we need to fetch the doctype from the intermediate.
+-  #
+-  #  Note: this is a very simplistic check - but as far as I know,
+-  #  it is correct. Am I right?
+-  #
+-  my $tmp = new FileHandle "<$tmpbase.2";
+-  my $dtd;
+-  while ( ($dtd = <$tmp>) && ! ( $dtd =~ /^\(/) ) { };
+-  $tmp->close;
+-  $dtd =~ s/^\(//;
+-  $dtd =~ tr/A-Z/a-z/;
+-  chop $dtd;
+-  $global->{dtd} = $dtd;
+-
+-  my $style = "";
+-  if ($global->{style})
+-    {
+-      $style = "$main::DataDir/site/$dtd/$global->{format}/$global->{style}mapping";
+-      -r $style or
+-         $style = "$main::DataDir/dist/$dtd/$global->{format}/$global->{style}mapping";
+-    }
+-  my $mapping = "$main::DataDir/site/$dtd/$global->{format}/mapping";
+-  -r $mapping or $mapping = "$main::DataDir/dist/$dtd/$global->{format}/mapping";
+ 
+-  $global->{charset} = "nippon" if ($global->{language} eq "ja");
+-  #
+-  # we don't have Korean groff so charset should be latin1.
+-  #
+-  if ($global->{language} eq "ko")
+-    {
+-      if ($global->{format} eq "groff")
+-        {
+-          $global->{charset} = "latin1";
+-        }
+-      else
+-        {
+-          $global->{charset} = "euc-kr";
+-        }
+-    }
+-  
+-  if ($global->{format} eq "groff" or $global->{format} eq "latex2e")
+-    {
+-      if ($dtd eq "linuxdoctr")
+-        {
+-          $mapping = "$main::DataDir/dist/$dtd/$global->{format}/tr-mapping";
+-        }
+-    }
++  my $style = ($global->{style}) ?
++    ldt_searchfile(["$main::DataDir/site/$dtd/$global->{format}/$global->{style}mapping",
++		    "$main::DataDir/dist/$dtd/$global->{format}/$global->{style}mapping",
++		    "$main::DataDir/mappings/$global->{format}/$global->{style}mapping"])
++    :
++    '';
+ 
+-  create_temp("$tmpbase.3");
+-  system ("$main::progs->{SGMLSASP} $style $mapping <\"$tmpbase.2\" |
+-      expand -$global->{tabsize} >\"$tmpbase.3\"");
+-  ! -e "$tmpbase.3" and die "can't create file - exiting";
++  my $mapping = ldt_searchfile(["$main::DataDir/site/$dtd/$global->{format}/mapping",
++				"$main::DataDir/dist/$dtd/$global->{format}/mapping",
++				"$main::DataDir/mappings/$global->{format}/mapping"])
++    or die "$error_header: Could not find mapping file for $dtd/$global->{format}. Aborting ...\n";
+ 
++  $mapping = "$style $mapping" if $style;
+ 
+-  if ( $global->{debug} )
+-    {
+-      print "ASP stage finished.\n";
++  if ($global->{format} eq "groff"){
++    if ($dtd eq "linuxdoctr") {
++      $mapping = "$main::DataDir/mappings/$global->{format}/tr-mapping";
+     }
++  }
++
++  my $sgmlsasp_command = "$main::progs->{SGMLSASP} $mapping < $preaspout |
++      expand -t $global->{tabsize} > $aspout";
++  ldt_log "  ${error_header}::sgmlsasp_command:\n    $sgmlsasp_command";
++  system ($sgmlsasp_command) == 0
++    or die "$error_header: Error running $sgmlsasp_command. Aborting ...\n";
++
++  die "$error_header: Can't create $aspout file. Aborting ...\n"
++    unless -e "$aspout";
++
++  print "- ASP stage finished.\n" if ( $global->{debug} );
++  ldt_log "- ASP stage finished.";
+ 
+-  #
+   #  If a postASP stage is defined, let the format handle it.
+-  #  It should leave whatever it thinks is right based on $file.
+-  #
+-  #  postASP ($inhandle)
+-  #
++  # ----------------------------------------------------------------
++  ldt_log "- postASP stage started.";
+   umask $saved_umask;
+-  my $inpostasp = new FileHandle "<$tmpbase.3";
+-  if (defined $Formats{$global->{format}}{postASP})
+-    {
+-      &{$Formats{$global->{format}}{postASP}}($inpostasp) == 0 or
+-	die "error post-processing $global->{format}.\n";
+-    }
+-  $inpostasp->close;
+-
+-  if ( $global->{debug} )
+-    {
+-      print "postASP stage finished.\n";
+-    }
+ 
+-  #
+-  #  All done, remove the temporaries.
+-  #
+-  if( !$global->{debug} ) {
+-      remove_tmpfiles($tmpbase);
++  open (my $INPOSTASP, "< $aspout" )
++    or die "$error_header: Could not open $aspout for reading. Aborting ...\n";
++  if (defined $Formats{$global->{format}}{postASP}) {
++    # Usage: postASP ($INHANDLE)
++    # Should leave whatever it thinks is right based on $INHANDLE.
++    &{$Formats{$global->{format}}{postASP}}($INPOSTASP) == 0
++      or die "$error_header: Error post-processing $global->{format}. Aborting ...\n";
+   }
++  close $INPOSTASP;
++
++  print "- postASP stage finished.\n" if ( $global->{debug} );
++  ldt_log "- postASP stage finished.";
++
++  # -- Reset $global->{logfile} for next file
++  $global->{logfile} = '';
++
++  # -- All done, remove the temporaries.
++  remove_tmpfiles($tmpbase) unless ( $global->{debug} );
+ }
+ 
+ =pod
+@@ -629,7 +648,7 @@ sub process_file
+ Documentation for various sub-packages of LinuxDocTools.
+ 
+ =head1 AUTHOR
+-SGMLTools are written by Cees de Groot, C<E<lt>cg@cdegroot.comE<gt>>, 
++SGMLTools are written by Cees de Groot, C<E<lt>cg@cdegroot.comE<gt>>,
+ and various SGML-Tools contributors as listed in C<CONTRIBUTORS>.
+ Taketoshi Sano C<E<lt>sano@debian.org<gt>> rename to LinuxDocTools.
+ 
+diff --git a/doc/sgml2html b/doc/sgml2html
+index ea8e8c9..98a688c 100755
+--- a/doc/sgml2html
++++ b/doc/sgml2html
+@@ -1,53 +1,76 @@
+ #!/usr/bin/perl 
+ #
+-#   sgmltools.in
+-#
+-#   $Id$
+-#
+-#   SGML-Tools driver. Calls all other SGML-Tools components, contains
+-#   configuration information, etcetera.
++#   linuxdoc.in
+ #
++#   LinuxDoc-Tools driver. Calls all other LinuxDoc-Tools components,
++#   contains configuration information, etcetera.
++# -------------------------------------------------------------------
++
+ package main;
+ 
+-sub BEGIN 
+-{
++sub BEGIN {
+   require 5.004;
+ }
++
+ use strict;
+ 
+-use vars qw($prefix $DataDir $BinDir $progs);
++use vars qw($prefix
++	    $isoentities_prefix
++	    $DataDir
++	    $AuxBinDir
++	    $progs);
+ 
+ use FindBin;
+ 
+-$prefix = "/usr";
+-$DataDir = "$FindBin::Bin/sbase";
+-$BinDir = "/usr/bin";
++$prefix             = "/usr";
++$isoentities_prefix = "/usr";
++$DataDir            = "$FindBin::Bin/sbase";
++$AuxBinDir          = "/usr/lib/linuxdoc-tools";
+ 
+ use lib "/usr/share/linuxdoc-tools";
+-use lib "/usr/perl5";
+-use lib "/usr/lib/perl5";
+ use lib "/usr/share/perl5";
+-$progs = {
+-  "NSGMLS" => "/usr/bin/nsgmls",
+-  "SGMLSASP" => "/usr/bin/sgmlsasp",
+-  "GROFF" => "/usr/bin/groff",
++
++# ---------------------------------------------------------------------
++sub ldt_which {
++# ---------------------------------------------------------------------
++# ---------------------------------------------------------------------
++  die "ldt_which: No filename(s) array given. Aborting ...\n" unless scalar @_;
++
++  foreach my $file ( @_ ){
++    if ( $file =~ m/\// ) {
++      return $file if -x $file;
++    } else {
++      foreach my $path ( split(':',$ENV{'PATH'}) ){
++	$path =~ s/\/+$//;
++	return $file if -x "$path/$file";
++      }
++    }
++  }
++  die "No executable found in path for (", join(' ',@_) ,"). Aborting ...\n";
++}
++
++$progs   = {
++  "SGMLSASP"   => ldt_which("sgmlsasp"),
++  "NSGMLS"     => ldt_which("nsgmls","onsgmls"),
++  "GROFF"      => ldt_which("groff"),
+   "GROFFMACRO" => "-ms",
+-  "AWK" => "/usr/share/linuxdoc-tools/awkwhich"
++#  "NKF" => "@NKF@"
+ };
+ 
+-if (! -x $progs->{"NSGMLS"})
+-  { $progs->{"NSGMLS"} = "/usr/bin/onsgmls"; }
+-
+ $ENV{"SGML_CATALOG_FILES"} = "$DataDir/dtd/catalog" .
+   (defined $ENV{SGML_CATALOG_FILES} ? ":$ENV{SGML_CATALOG_FILES}" : "");
+ 
+ require "$FindBin::Bin/LinuxDocTools.pm";
+ &LinuxDocTools::init;
+ 
+-my @FileList = LinuxDocTools::process_options ("html", @ARGV);
+-for my $curfile (@FileList)
+-  {
+-    LinuxDocTools::process_file ($curfile);
+-  }
++my @FileList = LinuxDocTools::process_options ($0, @ARGV);
++
++foreach my $curfile (@FileList) {
++  &LinuxDocTools::process_file ($curfile);
++}
+ 
+ exit 0;
++
++# Local Variables:
++#  mode: perl
++# End:
+diff --git a/doc/sgml2latex b/doc/sgml2latex
+index 79c6df0..98a688c 100755
+--- a/doc/sgml2latex
++++ b/doc/sgml2latex
+@@ -1,53 +1,76 @@
+ #!/usr/bin/perl 
+ #
+-#   sgmltools.in
+-#
+-#   $Id$
+-#
+-#   SGML-Tools driver. Calls all other SGML-Tools components, contains
+-#   configuration information, etcetera.
++#   linuxdoc.in
+ #
++#   LinuxDoc-Tools driver. Calls all other LinuxDoc-Tools components,
++#   contains configuration information, etcetera.
++# -------------------------------------------------------------------
++
+ package main;
+ 
+-sub BEGIN 
+-{
++sub BEGIN {
+   require 5.004;
+ }
++
+ use strict;
+ 
+-use vars qw($prefix $DataDir $BinDir $progs);
++use vars qw($prefix
++	    $isoentities_prefix
++	    $DataDir
++	    $AuxBinDir
++	    $progs);
+ 
+ use FindBin;
+ 
+-$prefix = "/usr";
+-$DataDir = "$FindBin::Bin/sbase";
+-$BinDir = "/usr/bin";
++$prefix             = "/usr";
++$isoentities_prefix = "/usr";
++$DataDir            = "$FindBin::Bin/sbase";
++$AuxBinDir          = "/usr/lib/linuxdoc-tools";
+ 
+ use lib "/usr/share/linuxdoc-tools";
+-use lib "/usr/perl5";
+-use lib "/usr/lib/perl5";
+ use lib "/usr/share/perl5";
+-$progs = {
+-  "NSGMLS" => "/usr/bin/nsgmls",
+-  "SGMLSASP" => "/usr/bin/sgmlsasp",
+-  "GROFF" => "/usr/bin/groff",
++
++# ---------------------------------------------------------------------
++sub ldt_which {
++# ---------------------------------------------------------------------
++# ---------------------------------------------------------------------
++  die "ldt_which: No filename(s) array given. Aborting ...\n" unless scalar @_;
++
++  foreach my $file ( @_ ){
++    if ( $file =~ m/\// ) {
++      return $file if -x $file;
++    } else {
++      foreach my $path ( split(':',$ENV{'PATH'}) ){
++	$path =~ s/\/+$//;
++	return $file if -x "$path/$file";
++      }
++    }
++  }
++  die "No executable found in path for (", join(' ',@_) ,"). Aborting ...\n";
++}
++
++$progs   = {
++  "SGMLSASP"   => ldt_which("sgmlsasp"),
++  "NSGMLS"     => ldt_which("nsgmls","onsgmls"),
++  "GROFF"      => ldt_which("groff"),
+   "GROFFMACRO" => "-ms",
+-  "AWK" => "/usr/share/linuxdoc-tools/awkwhich"
++#  "NKF" => "@NKF@"
+ };
+ 
+-if (! -x $progs->{"NSGMLS"})
+-  { $progs->{"NSGMLS"} = "/usr/bin/onsgmls"; }
+-
+ $ENV{"SGML_CATALOG_FILES"} = "$DataDir/dtd/catalog" .
+   (defined $ENV{SGML_CATALOG_FILES} ? ":$ENV{SGML_CATALOG_FILES}" : "");
+ 
+ require "$FindBin::Bin/LinuxDocTools.pm";
+ &LinuxDocTools::init;
+ 
+-my @FileList = LinuxDocTools::process_options ("latex", @ARGV);
+-for my $curfile (@FileList)
+-  {
+-    LinuxDocTools::process_file ($curfile);
+-  }
++my @FileList = LinuxDocTools::process_options ($0, @ARGV);
++
++foreach my $curfile (@FileList) {
++  &LinuxDocTools::process_file ($curfile);
++}
+ 
+ exit 0;
++
++# Local Variables:
++#  mode: perl
++# End:
+diff --git a/doc/sgml2txt b/doc/sgml2txt
+index 013479f..98a688c 100755
+--- a/doc/sgml2txt
++++ b/doc/sgml2txt
+@@ -1,53 +1,76 @@
+ #!/usr/bin/perl 
+ #
+-#   sgmltools.in
+-#
+-#   $Id$
+-#
+-#   SGML-Tools driver. Calls all other SGML-Tools components, contains
+-#   configuration information, etcetera.
++#   linuxdoc.in
+ #
++#   LinuxDoc-Tools driver. Calls all other LinuxDoc-Tools components,
++#   contains configuration information, etcetera.
++# -------------------------------------------------------------------
++
+ package main;
+ 
+-sub BEGIN 
+-{
++sub BEGIN {
+   require 5.004;
+ }
++
+ use strict;
+ 
+-use vars qw($prefix $DataDir $BinDir $progs);
++use vars qw($prefix
++	    $isoentities_prefix
++	    $DataDir
++	    $AuxBinDir
++	    $progs);
+ 
+ use FindBin;
+ 
+-$prefix = "/usr";
+-$DataDir = "$FindBin::Bin/sbase";
+-$BinDir = "/usr/bin";
++$prefix             = "/usr";
++$isoentities_prefix = "/usr";
++$DataDir            = "$FindBin::Bin/sbase";
++$AuxBinDir          = "/usr/lib/linuxdoc-tools";
+ 
+ use lib "/usr/share/linuxdoc-tools";
+-use lib "/usr/perl5";
+-use lib "/usr/lib/perl5";
+ use lib "/usr/share/perl5";
+-$progs = {
+-  "NSGMLS" => "/usr/bin/nsgmls",
+-  "SGMLSASP" => "/usr/bin/sgmlsasp",
+-  "GROFF" => "/usr/bin/groff",
++
++# ---------------------------------------------------------------------
++sub ldt_which {
++# ---------------------------------------------------------------------
++# ---------------------------------------------------------------------
++  die "ldt_which: No filename(s) array given. Aborting ...\n" unless scalar @_;
++
++  foreach my $file ( @_ ){
++    if ( $file =~ m/\// ) {
++      return $file if -x $file;
++    } else {
++      foreach my $path ( split(':',$ENV{'PATH'}) ){
++	$path =~ s/\/+$//;
++	return $file if -x "$path/$file";
++      }
++    }
++  }
++  die "No executable found in path for (", join(' ',@_) ,"). Aborting ...\n";
++}
++
++$progs   = {
++  "SGMLSASP"   => ldt_which("sgmlsasp"),
++  "NSGMLS"     => ldt_which("nsgmls","onsgmls"),
++  "GROFF"      => ldt_which("groff"),
+   "GROFFMACRO" => "-ms",
+-  "AWK" => "/usr/share/linuxdoc-tools/awkwhich"
++#  "NKF" => "@NKF@"
+ };
+ 
+-if (! -x $progs->{"NSGMLS"})
+-  { $progs->{"NSGMLS"} = "/usr/bin/onsgmls"; }
+-
+ $ENV{"SGML_CATALOG_FILES"} = "$DataDir/dtd/catalog" .
+   (defined $ENV{SGML_CATALOG_FILES} ? ":$ENV{SGML_CATALOG_FILES}" : "");
+ 
+ require "$FindBin::Bin/LinuxDocTools.pm";
+ &LinuxDocTools::init;
+ 
+-my @FileList = LinuxDocTools::process_options ("txt", @ARGV);
+-for my $curfile (@FileList)
+-  {
+-    LinuxDocTools::process_file ($curfile);
+-  }
++my @FileList = LinuxDocTools::process_options ($0, @ARGV);
++
++foreach my $curfile (@FileList) {
++  &LinuxDocTools::process_file ($curfile);
++}
+ 
+ exit 0;
++
++# Local Variables:
++#  mode: perl
++# End:
diff --git a/distro/pkg/deb/patches/series b/distro/pkg/deb/patches/series
new file mode 100644
index 00000000..3a10aac9
--- /dev/null
+++ b/distro/pkg/deb/patches/series
@@ -0,0 +1 @@
+0001-Sync-the-linuxdoc-mangled-files-with-linuxdoc-tools_.patch
diff --git a/distro/pkg/deb/prepare-environment b/distro/pkg/deb/prepare-environment
new file mode 100755
index 00000000..d782c140
--- /dev/null
+++ b/distro/pkg/deb/prepare-environment
@@ -0,0 +1,28 @@
+#!/bin/sh
+
+set -eu
+
+BIRD_RUN_DIR=/run/bird
+. /etc/bird/envvars
+
+
+mkdir --parents "$BIRD_RUN_DIR";
+
+if [ -n "$BIRD_RUN_USER" ]; then
+    if ! getent passwd $BIRD_RUN_USER >/dev/null; then
+	echo "Configured user '$BIRD_RUN_USER' doesn't exist."
+	exit 1
+    fi
+fi
+
+if [ -n "$BIRD_RUN_GROUP" ]; then
+    if ! getent group $BIRD_RUN_GROUP >/dev/null; then
+	echo "Configured group '$BIRD_RUN_GROUP' doesn't exist."
+	exit 1
+    fi
+fi
+
+chown --silent "$BIRD_RUN_USER:$BIRD_RUN_GROUP" "$BIRD_RUN_DIR"
+chmod 775 "$BIRD_RUN_DIR"
+
+:
diff --git a/distro/pkg/deb/rules b/distro/pkg/deb/rules
new file mode 100755
index 00000000..5630ed1c
--- /dev/null
+++ b/distro/pkg/deb/rules
@@ -0,0 +1,56 @@
+#!/usr/bin/make -f
+# -*- makefile -*-
+# This file was originally written by Joey Hess and Craig Small.
+# As a special exception, when this file is copied by dh-make into a
+# dh-make output file, you may use that output file without restriction.
+# This special exception was added by Craig Small in version 0.37 of dh-make.
+
+export DEB_BUILD_MAINT_OPTIONS = hardening=+all
+DPKG_EXPORT_BUILDFLAGS = 1
+include /usr/share/dpkg/default.mk
+
+COMMON_FLAGS= --prefix=/usr --sysconfdir=/etc/bird --mandir=\$${prefix}/share/man \
+	--infodir=\$${prefix}/share/info --localstatedir=/var --runstatedir=/run/bird \
+	--docdir=\$${prefix}/share/bird2 \
+	--enable-client
+
+CFLAGS += -g -O2 -fno-strict-aliasing -fno-strict-overflow -fPIC
+LDFLAGS += -g -O2 -fno-strict-aliasing -fno-strict-overflow -fPIC -Wl,-z,defs -Wl,--as-needed
+
+%:
+	dh $@
+
+override_dh_auto_configure:
+	CFLAGS="$(CFLAGS)" LDFLAGS="$(LDFLAGS)" dh_auto_configure -- $(COMMON_FLAGS) --with-protocols=all
+
+override_dh_auto_build:
+	dh_auto_build
+	dh_auto_build -- docs
+
+override_dh_auto_install:
+	dh_auto_install --destdir=debian/tmp
+
+override_dh_installinit:
+	dh_installinit --name=bird --restart-after-upgrade
+
+override_dh_installsystemd:
+	dh_installsystemd --name=bird --restart-after-upgrade
+
+DB2MAN = /usr/share/sgml/docbook/stylesheet/xsl/nwalsh/manpages/docbook.xsl
+XP     = xsltproc -''-nonet -''-param man.charmap.use.subset "0"
+
+bird.8: debian/bird.xml
+	$(XP) $(DB2MAN) $<
+
+override_dh_installman: bird.8
+	dh_installman
+
+override_dh_clean:
+	dh_clean
+	-rm -f bird.8 birdc.8
+
+override_dh_missing:
+	dh_missing  --fail-missing
+
+override_dh_compress:
+	dh_compress -X.conf
diff --git a/distro/pkg/deb/source/format b/distro/pkg/deb/source/format
new file mode 100644
index 00000000..163aaf8d
--- /dev/null
+++ b/distro/pkg/deb/source/format
@@ -0,0 +1 @@
+3.0 (quilt)
diff --git a/distro/pkg/deb/watch b/distro/pkg/deb/watch
new file mode 100644
index 00000000..1874bfbb
--- /dev/null
+++ b/distro/pkg/deb/watch
@@ -0,0 +1,2 @@
+version=3
+https://bird.network.cz/download/bird-(2\.[\d.]+).tar.gz