Document modhex

diff --git a/debian/changelog b/debian/changelog
index 092eded92dfc98284035782ab39df4359af54b07..b860282fa992fdd1bbdfa227093fb6a074e31c68 100644 (file)
--- 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 946dd3f9d6798bb1b69a900886b911f1beba67d5..7d432a8038f98d5cd28a5943e937e37489e6abee 100644 (file)
--- 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"