Browse Source

arch: Add a version pseudo-field to the arch tables

This should allow external parsers to know if they can understand the
table contents.
Guillem Jover 8 years ago
parent
commit
16847ec012
6 changed files with 16 additions and 0 deletions
  1. 2 0
      data/abitable
  2. 2 0
      data/cputable
  3. 2 0
      data/ostable
  4. 2 0
      data/triplettable
  5. 1 0
      debian/changelog
  6. 7 0
      man/dpkg-architecture.man

+ 2 - 0
data/abitable

@@ -1,3 +1,5 @@
+# Version=1.0
+#
 # This file contains the table of arch ABI attribute overrides.
 #
 # If the ABI is not present here then the attribute information for a

+ 2 - 0
data/cputable

@@ -1,3 +1,5 @@
+# Version=1.0
+#
 # This file contains the table of known CPU names.
 #
 # Architecture names are formed as a combination of the system name

+ 2 - 0
data/ostable

@@ -1,3 +1,5 @@
+# Version=1.0
+#
 # This file contains the table of known operating system names.
 #
 # Architecture names are formed as a combination of the system name

+ 2 - 0
data/triplettable

@@ -1,3 +1,5 @@
+# Version=1.0
+#
 # Bidirectional mapping between a Debian triplet and a Debian arch.
 #
 # Supported variables: <cpu>

+ 1 - 0
debian/changelog

@@ -57,6 +57,7 @@ dpkg (1.18.11) UNRELEASED; urgency=medium
   * Give more information on --set-selections warnings. Closes: #842230
   * Architecture support:
     - Add support for AIX operating system.
+    - Add a version pseudo-field to the arch tables.
   * Portability:
     - Cast off_t variables to intmax_t when printing them with "%jd".
     - Add missing <string.h> include in libdpkg.

+ 7 - 0
man/dpkg-architecture.man

@@ -222,19 +222,26 @@ paths (since dpkg 1.17.14).
 All these files have to be present for \fBdpkg\-architecture\fP to
 work. Their location can be overridden at runtime with the environment
 variable \fBDPKG_DATADIR\fP.
+These tables contain a format \fBVersion\fP pseudo-field on their first
+line to mark their format, so that parsers can check if they understand
+it, such as "# Version=1.0".
 .TP
 .I %PKGDATADIR%/cputable
 Table of known CPU names and mapping to their GNU name.
+Format version 1.0 (since dpkg 1.13.2).
 .TP
 .I %PKGDATADIR%/ostable
 Table of known operating system names and mapping to their GNU name.
+Format version 1.0 (since dpkg 1.13.2).
 .TP
 .I %PKGDATADIR%/triplettable
 Mapping between Debian architecture triplets and Debian architecture
 names.
+Format version 1.0 (since dpkg 1.14.0).
 .TP
 .I %PKGDATADIR%/abitable
 Table of Debian architecture ABI attribute overrides.
+Format version 1.0 (since dpkg 1.16.3).
 .SS Packaging support
 .TP
 .I %PKGDATADIR%/architecture.mk