From 476c966037dfec5a0a2b03511dced36c673c2307 Mon Sep 17 00:00:00 2001
From: ian <ian>
Date: Thu, 25 Nov 2004 00:20:56 +0000
Subject: [PATCH] error codes and better docs for mask-map

---
 base/chiark-tcl.h | 12 ++++++++----
 hbytes/hbytes.h   | 12 ++++++++----
 2 files changed, 16 insertions(+), 8 deletions(-)

diff --git a/base/chiark-tcl.h b/base/chiark-tcl.h
index 207e32a..f57b037 100644
--- a/base/chiark-tcl.h
+++ b/base/chiark-tcl.h
@@ -68,10 +68,10 @@
  *  hbytes mask-map lookup MAP-VAR ADDRESS [DEFAULT]   => DATA
  *     error on missing default or if address too short
  *  hbytes mask-map amend MAP-VAR PREFIX PREFIX-LENGTH DATA
- *     a maskmap MAP is [list [list PREFIX PREFIX-LENGTH DATA]]
- *     sorted first by descending PREFIX-LENGTH and then by PREFIX
- *     each PREFIX is truncated to the shortest number of pairs of
- *     hex digits which can represent it
+ *     a maskmap MAP is [list [list PREFIX PREFIX-LENGTH DATA]] sorted
+ *     first by descending PREFIX-LENGTH and then by ascending PREFIX
+ *     each PREFIX _in the map_ is truncated to the shortest number of
+ *     pairs of hex digits which can represent it
  *
  * Error codes
  *
@@ -86,6 +86,10 @@
  * HBYTES LENGTH MISMATCH              when blocks must be exactly same length
  * HBYTES SYNTAX                       supposed hex block had wrong syntax
  * HBYTES VALUE OVERFLOW               value to be conv'd to hex too big/long
+ * HBYTES MASKMAP SYNTAX LLENGTH       value for mask-map entry not llength==3
+ * HBYTES MASKMAP SYNTAX UNDERRUN      value for mask-map entry hex too short
+ * HBYTES MASKMAP SYNTAX OVERRUN       actual mask-map entry hex too short
+ * HBYTES MASKMAP SYNTAX ORDER         actual mask-map is disordered
  * SOCKADDR AFUNIX LENGTH              path for AF_UNIX socket too long
  * SOCKADDR SYNTAX IPV4                bad IPv4 socket address &/or port
  * SOCKADDR SYNTAX OTHER               bad socket addr, couldn't tell what kind
diff --git a/hbytes/hbytes.h b/hbytes/hbytes.h
index 207e32a..f57b037 100644
--- a/hbytes/hbytes.h
+++ b/hbytes/hbytes.h
@@ -68,10 +68,10 @@
  *  hbytes mask-map lookup MAP-VAR ADDRESS [DEFAULT]   => DATA
  *     error on missing default or if address too short
  *  hbytes mask-map amend MAP-VAR PREFIX PREFIX-LENGTH DATA
- *     a maskmap MAP is [list [list PREFIX PREFIX-LENGTH DATA]]
- *     sorted first by descending PREFIX-LENGTH and then by PREFIX
- *     each PREFIX is truncated to the shortest number of pairs of
- *     hex digits which can represent it
+ *     a maskmap MAP is [list [list PREFIX PREFIX-LENGTH DATA]] sorted
+ *     first by descending PREFIX-LENGTH and then by ascending PREFIX
+ *     each PREFIX _in the map_ is truncated to the shortest number of
+ *     pairs of hex digits which can represent it
  *
  * Error codes
  *
@@ -86,6 +86,10 @@
  * HBYTES LENGTH MISMATCH              when blocks must be exactly same length
  * HBYTES SYNTAX                       supposed hex block had wrong syntax
  * HBYTES VALUE OVERFLOW               value to be conv'd to hex too big/long
+ * HBYTES MASKMAP SYNTAX LLENGTH       value for mask-map entry not llength==3
+ * HBYTES MASKMAP SYNTAX UNDERRUN      value for mask-map entry hex too short
+ * HBYTES MASKMAP SYNTAX OVERRUN       actual mask-map entry hex too short
+ * HBYTES MASKMAP SYNTAX ORDER         actual mask-map is disordered
  * SOCKADDR AFUNIX LENGTH              path for AF_UNIX socket too long
  * SOCKADDR SYNTAX IPV4                bad IPv4 socket address &/or port
  * SOCKADDR SYNTAX OTHER               bad socket addr, couldn't tell what kind
-- 
2.30.2