summaryrefslogtreecommitdiff
path: root/data/tupletable
diff options
context:
space:
mode:
Diffstat (limited to 'data/tupletable')
-rw-r--r--data/tupletable15
1 files changed, 15 insertions, 0 deletions
diff --git a/data/tupletable b/data/tupletable
index 6fadf11ef..b83c4bf8d 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>