X-Git-Url: http://www.chiark.greenend.org.uk/ucgi/~ian/git?a=blobdiff_plain;f=hbytes%2Fhbytes.h;h=48ee798333a64d33a93f6332606b06cd2c11114f;hb=6235da689cb928ce3b4f9e6deb4a50a5b9c841fb;hp=207e32a73f9d517b52fe59002135cc2db8eeadc8;hpb=20f8f9dd8dcdc4b5c68331c8015c18eaf1813360;p=chiark-tcl.git

diff --git a/hbytes/hbytes.h b/hbytes/hbytes.h
index 207e32a..48ee798 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,11 @@
  * 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
+ * HBYTES MASKMAP SYNTAX EXCLBITS      mask-map has 1-bits outside prefix len
  * 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