From: Tollef Fog Heen <tfheen@err.no>
Date: Fri, 31 Dec 2010 08:18:28 +0000 (+0100)
Subject: Document modhex
X-Git-Tag: yubikey-personalisation_1.3.5-1
X-Git-Url: https://err.no/cgi-bin/gitweb.cgi?a=commitdiff_plain;h=75f9e736b4cab9b3a232f2807854f4923f3a5e60;p=yubikey-personalization.old

Document modhex
---

diff --git a/debian/changelog b/debian/changelog
index 092eded..b860282 100644
--- a/debian/changelog
+++ b/debian/changelog
@@ -3,6 +3,7 @@ yubikey-personalization (1.3.5-1) unstable; urgency=low
   * New upstream release
     - Fix salt in AES key generation Closes: #608443
   * Update link to Yubikey manual
+  * Document modhex.  Closes: #593937.
 
  -- Tollef Fog Heen <tfheen@debian.org>  Fri, 31 Dec 2010 09:16:31 +0100
 
diff --git a/ykpersonalize.1 b/ykpersonalize.1
index 946dd3f..7d432a8 100644
--- a/ykpersonalize.1
+++ b/ykpersonalize.1
@@ -206,6 +206,17 @@ When using OATH-HOTP mode, the key that is shared with the server
 consists of the AES key plus the first four bytes (eight hex
 characters) of the UID.  The token identifier is defined by the fixed
 prefix.
+.SH Modhex
+Modhex is a way of writing hex digits where the \(lqdigits\(rq are
+chosen for being in the same place on most keyboard layouts.  To
+convert from hex to modhex, you can use
+.RS
+tr "[0123456789abcdef]" "[cbdefghijklnrtuv]"
+.RE
+To convert the other way, use 
+.RS
+tr "[cbdefghijklnrtuv]" "[0123456789abcdef]"
+.RE
 .SH BUGS
 Report ykpersonalize bugs in 
 .URL "http://code.google.com/p/yubikey-personalization/issues/list" "the issue tracker"