This is an automated email from the git hooks/post-receive script.

guillem pushed a commit to branch master
in repository dpkg.

View the commit online:
https://git.dpkg.org/cgit/dpkg/dpkg.git/commit/?id=b910e58aed06d3fbca0645bd68c2105d1dfa003c

commit b910e58aed06d3fbca0645bd68c2105d1dfa003c (HEAD -> master)
Author: Guillem Jover <[email protected]>
AuthorDate: Thu Aug 30 02:38:39 2018 +0200

    data: Add missing purpose and column description for tupletable
---
 data/tupletable  | 15 +++++++++++++++
 debian/changelog |  1 +
 2 files changed, 16 insertions(+)

diff --git a/data/tupletable b/data/tupletable
index b7802bec3..a7a878f5b 100644
--- a/data/tupletable
+++ b/data/tupletable
@@ -2,6 +2,21 @@
 #
 # Bidirectional mapping between a Debian arch tuple and a Debian arch name.
 #
+# Debian arch tuple names are formed as a combination of the Debian system
+# name (from the ostable) and the Debian CPU name (from the cputable) after
+# applying the variable substitutions. Debian arch names are the result of
+# historical naming conventions in Debian, where the predominant system
+# architectures have many of their parts in implicit form, by only exposing
+# the CPU with the ABI bolted on, where less common architectures have their
+# OS part spelled out, and where even less common ones, have their libc
+# spelled out. This table maps between the ideal architecture tuple, with
+# the current messy reality.
+#
+# - Column 1 is the Debian arch tuple name, as the normalized form of the
+#   architecture names, used as the internal representation.
+# - Column 2 is the Debian arch name, as the abbreviated form of the
+#   architecture names, used as the public interface.
+#
 # Supported variables: <cpu>
 #
 # <Debian arch tuple>          <Debian arch name>
diff --git a/debian/changelog b/debian/changelog
index 0bb03dd40..f2eef27f2 100644
--- a/debian/changelog
+++ b/debian/changelog
@@ -96,6 +96,7 @@ dpkg (1.19.1) UNRELEASED; urgency=medium
   * Architecture support:
     - Add support for riscv64 CPU. Closes: #822914
       Thanks to Manuel A. Fernandez Montecelo <[email protected]>
+    - Document the purpose and columns in the tupletable file.
   * Portability:
     - Add libcompat md5 module to the libcompat-test library, so that we
       always make sure it builds, even when we use an external implementation.

-- 
Dpkg.Org's dpkg

Reply via email to