Subject: CVS commit: pkgsrc/converters/py-zbase32
From: Greg Troxel
Date: 2010-07-24 19:56:27
Message id: 20100724175627.22023175DD@cvs.netbsd.org

Log Message:
Import py26-zbase32-1.1.2 as converters/py-zbase32.

An alternate base32 encoder (not RFC 3548 compliant).

The rationale for base-32 encoding in RFC 3548 [1] is as written therein: "The
Base 32 encoding is designed to represent arbitrary sequences of octets in a
form that needs to be case insensitive but need not be humanly readable.".

The rationale for our encoding is different -- it is to represent arbitrary
sequences of octets in a form that is as convenient as possible for human
users to manipulate.  In particular, z-base-32 was created in order to serve
the Mnet project [3], where 30-octet cryptographic values are encoded into
URIs for humans to manipulate.  Anticipated uses of these URIs include cut-
and-paste, text editing (e.g. in HTML files), manual transcription via a
keyboard, manual transcription via pen-and-paper, vocal transcription over
phone or radio, etc.

The desiderata for such an encoding are:

 * minimizing transcription errors -- e.g. the well-known problem of confusing
   `0' with `O'
 * embedding into other structures -- e.g. search engines, structured or
   marked-up text, file systems, command shells
 * brevity -- Shorter URLs are better than longer ones.
 * ergonomics -- Human users (especially non-technical ones) should find the
   URIs as easy and pleasant as possible.  The uglier the URI looks, the worse.


Files:
RevisionActionfile
1.1importpkgsrc/converters/py-zbase32/Makefile
1.1importpkgsrc/converters/py-zbase32/PLIST
1.1importpkgsrc/converters/py-zbase32/DESCR
1.1importpkgsrc/converters/py-zbase32/distinfo