Add DocBook version of deb-old(5) manpage

diff --git a/ChangeLog b/ChangeLog
index b85759374aea61637890f4158217e6a7842fb8ab..b8b22f379239af25af482f897db9d3a9be7bfc88 100644 (file)
--- a/ChangeLog
+++ b/ChangeLog
@@ -1,3 +1,7 @@
+Sun Apr 14 16:13:16 CEST 2002 Wichert Akkerman <wichert@deephackmode.org>
+
+  * man/en/deb-old.5.sgml: DocBook version of deb-old manpage
+
 Sun Apr 14 00:49:09 CEST 2002 Wichert Akkerman <wichert@deephackmode.org>
 
   * scripts/controlllib.pl: accept multilpe consectucive empty lines

diff --git a/man/en/deb-old.5.sgml b/man/en/deb-old.5.sgml
new file mode 100644 (file)
index 0000000..6b68cc8
--- /dev/null
+++ b/man/en/deb-old.5.sgml
@@ -0,0 +1,100 @@
+<!DOCTYPE refentry PUBLIC "-//OASIS//DTD DocBook V4.1//EN">
+
+<refentry id="deb-old.5">
+  <refmeta>
+    <refentrytitle>deb-old</refentrytitle>
+    <manvolnum>5</manvolnum>
+    <refmiscinfo class="source">Debian Project</refmiscinfo>
+    <refmiscinfo class="manua"'>dpkg suite</refmiscinfo>
+  </refmeta>
+
+  <refnamediv>
+    <refname>deb-old</refname>
+    <refpurpose>old style Debian binary package format</refpurpose>
+  </refnamediv>
+
+  <refsynopsisdiv>
+    <synopsis><filename>filename.deb</filename></synopsis>
+  </refsynopsisdiv>
+
+  <refsect1>
+    <title>Description</title>
+
+    <para>
+      The <filename>.deb</filename> format is the Debian binary package file
+      format. This manual page describes the <emphasis>old</emphasis> format,
+      used before Debian 0.93. Please see
+      <citerefentry><refentrytitle>deb</refentrytitle><manvolnum>5</manvolnum></citerefentry>
+      for details of the new format.
+    </para>
+  </refsect1>
+
+  <refsect1>
+    <title>Format</title>
+
+    <para>
+      The file is two lines of format information as ASCII text, followed by
+      two concatenated gzipped ustar files.
+    </para>
+
+    <para>
+      The first line is the format version number padded to 8 digits, and is
+      <emphasis'>0.939000</emphasis> for all old-format archives.
+    </para>
+
+    <para>
+      The second line is a decimal string (without leading zeroes) giving the
+      length of the first gzipped tarfile.
+    </para>
+
+    <para>
+      Each of these lines is terminated with a single newline character.
+    </para>
+
+    <para>
+      The first tarfile contains the control information, as a series of
+      ordinary files, described in the Debian Packaging Manual. The file
+      <filename>control</emphasis> must be present, as it contains the core
+      control information.
+    </para>
+
+    <para>
+      In some very old archives, the files in the control tarfile may
+      optionally be in a <filename>DEBIAN</filename> subdirectory. In that
+      case, the <filename>DEBIAN</emphasis> subdirectory will be in the control
+      tarfile too, and the control tarfile will have only files in that
+      directory. Optionally the control tarfile may contain an entry for
+      `<filename>.</filename>', that is, the current directory.
+    </para>
+
+    <para>
+      The second gzipped tarfile is the filesystem archive, containing
+      pathnames relative to the root directory of the system to be installed
+      on. The pathnames do not have leading slashes.
+    </para>
+  </refsect1>
+
+  <refsect1>
+    <title>See Also</title>
+
+    <para>
+      <citerefentry>
+        <refentrytitle>deb</refentrytitle>
+       <manvolnum>5</manvolnum>
+      </citerefentry>,
+
+      <citerefentry>
+        <refentrytitle>dpkg-deb</refentrytitle>
+       <manvolnum>1</manvolnum>
+      </citerefentry>,
+
+      <citerefentry>
+        <refentrytitle>deb-control</refentrytitle>
+       <manvolnum>5</manvolnum>
+      </citerefentry>,
+
+      Debian Packaging Manual
+    </para>
+  </refsect1>
+</refentry>
+